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Introducing ProtoGen+. Visual tools with the most awesome 
workbench ever created tor Windows development. 


he future has arrived—a complete 
point-and-click, WYSIWYG 
workbench that lets you create 
dazzling applications without 
writing a line of code. 


Discover the ease and 
productivity of visual 
development! 


Paint your 
screens. Design 
a menu and link 


screens togeth¬ 
er. Test the flow 
in a live environ¬ 
ment, and gen¬ 
erate code for 
ANSI C, C++ 
for OWL or MFC 
or Pascal with 
objects. It's that 
easy. 

And this 

open! ProtoGen+ 
will work with 
your database, 
compiler, 
libraries and extensions. Powerful 


Visually 

develop 

screens 



Create a menu 
and connect 
screens & dialogs 



Test the applica¬ 
tion's screen (low in 
a live environment 



Instantly generate 
source code in 
Pascal, C or C++ 


add-on features, like SQLView offer 
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Bring your applications to life using the latest 
visual design tools! 


M30 LQ 


workbench access to multiple 
databases to develop client/server and 
xBase applications. Snap-in compo¬ 
nents make ProtoGen+ open to future 
development technologies—whatever 
they may be. 

ProtoGen+ is easy to learn, 
speeds your development cycle and 
protects your investment by generat¬ 
ing C,C++ and Pascal. We guarantee 
you'll 
prototype 
and generate 
exciting 
applications 
faster than 
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Point-and-click to paint 
screens with bitmaps, 
icons, tables, data valida¬ 
tion, custom colors, fonts, 
3D effects, visual tool¬ 
bars, status lines, balloon 
help, MDI and more! 


you ever 

thought 

possible! 
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file Visual Development Edge™ 

All products named are trademarks of their 
respective companies. ©1993 ProtoView Development 


The most powerful, open set of 
Visual Development Tools ever! 


Build win¬ 
dows, forms, 
dialog boxes, 
tool bars 

Dialog 

Editor 

Menu 

Designer 

Quickly 
create a 
menu using 
templates 

Output C. 
C++ and 
Pascal with 
Objects 

Code 

Gener¬ 

ator 

ProtoView 

Screen 

Manager 

Data valida¬ 
tion, 3-D 
effects, MDI 
and more 




Create new 
designers! 
Source 
included 

Custom 

Visual 

Designer 

Win- 

Control 

Library 

Rich library 
of visual 
control 
objects 


Snap-in 

Code 

Generators 



License our technology to 
create new code generators 


Fasten your seatbelt 
for ProtoGen+! 


Only 


(list price 
$395) 


$199 

1 - 800 - 231-8588 

Ask for Ext. 60 
In NJ, call (908) 329-8588 
ProtoGen+'s SQLView access to multiple 
databases is available at an additional price; 
ask about it when you call. 
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Declare Your DBMS Independence 


New ! Q + E Database Library 2 



Software 


5540 Centerview Drive • Suite 324 
Raleigh, N.C. 27606 * 919 859-2220 
fox 919 859-9334 * 800 876-3101 
In Europe: 

P.0. Box 84.034 » 3009 CA * Rotterdam, The Netherlands 
(31) 10 2202 022 * Fax (31) 10 4563 348 


Use Q+E Database Library to 
develop powerful client server 
applications that work with 
all major databases. 

Q+E Database Library' 
eliminates the complex details 
of accessing and manipulating 
data from multiple data sources. 

Code Once 

Put world-class applications in 
your user's hands quickly by 
writing code once to access all 
major databases. In record 
time, you can build an 
application that accesses 
Oracle, dBASE, SQL Server, 
Paradox, DB2, or any other 
database. You can even prototype 
and test with one DBMS and 
deliver against another. 

Odbc And Idapi 

Q+E Database Library's high- 
level API allows you to create 
ODBC-compliant applications 
in a fraction of the time it 
takes with the ODBC SDK. 
Future releases of 
Q+E Database Library will 
automatically make 
these same applications 
IDAPI-compatible. Why risk 
making the wrong choice 
between competing standards? 
Use Q+E Database Library 
and instantly get support for 
both ODBC and IDAPI. 


All Development Tools 

Don't throw away your 
existing development 
environment just to gain 
DBMS independence. 

Q+E Database Library works 
with the tools you already 
have. It works with the macro, 
script, or programming 
language of any application or 
development tool, including 
C, COBOL, Pascal and 
Visual Basic. 

Cross Platform 

Get consistent DBMS access 
across all major operating 
systems*. With Q+E Database 
Library, your ODBC-compliant 
applications will run on all 
platforms—even those where 
ODBC is not yet supported. 

Get The Job Done 

Q+E Database Library comes 
with a complete set of database 
tools to help you get your job 
done faster. 


Proven Technolocy 

Employ the same technology 
used by Microsoft, Lotus, 
WordPerfect, Computer 
Associates, Borland, and IBM 
to create their DBMS- 
independent applications. 
Don't take chances. Use the 
industry's leading market- 
proven technology. 

CAL/ 

800 - 876-3101 

Order Q+E Database Library 
today and discover the best 
way to develop DBMS- 
independent client server 
applications. If after 30 days 
you don't love it, return it for 
a no-hassles refund. 

»$699 

Q+E Database Library 2 applications can be 
distributed royalty free. Distribution licenses are 
required for distribution of the Q+E database drivers. 
*Q+E Database Library Version 2 is available for 
Windows today and will support OS/2, Macintosh, 
Windows NT, and UNIX by the first quarter of 1994. 


© 1993 Q+E Software. Q+E is a registered trademark of Q+E Software. 
Other brands and product names are the property of their respective owners. 
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High-level API Eliminotes the complex details 

of accessing and monipulating 
data from multiple data 

_sources 

Includes Over 20 Drivers Btrieve, DB2f, DB2/2, 
dBASE, Excel, 

HP ALLBASE /SQL, 

HP IAAAGE/SQL, INFORMIX, 
INGRES, Microsoft SQL Server, 
NetWare SQL, Oracle, 
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SQL/DSt, 
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ODBC Compliance 

Enables ODBC application 
development 

Cross Platform 

Windows, Macintosh, UNIX, 
OS/2, Windows NT 

Q+E Query Builder 

Allows users of your 
applicotion to create complex 
SQL statements without 
knowing SQL 

Conversion Routines 

Conversion between different 
DBMS doto types 

Doto Dictionary 

Common doto dictionary 
functions for oil DBMS 

Find Functions 

Automates look-ups 
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Easily create Query by 
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Networks _ 

Network Programming and Visual Basic. 13 

Underlying the transparent file sharing that networks provide is an asynchronous protocol that you can put 
to other uses. This article looks at communicating across Novell networks via IPX. The author has written a 
Visual Basic VBX custom control that supports IPX and a VB “chat" program, both of which are available on 
the code disk. 

Lee Wiltbank 


Features 


Controlling WinHelp’s Always-on-Top State. 19 

WinHelp lets the user select an “always-on-top" menu item to keep the help window visible even after 
control returns to the application window. Sometimes you want to control the help window's always-on-top 
state programmatically. Unfortunately, that requires a little trickery. This article shows you how to control 
the help window's always-on-top state, either from your application code or from help macros compiled 
into the .hip file. 

Ron Burk 

A High-Resolution Windows C++ Timer Class. 23 

SetTimerQ provides timers, but Windows only delivers WM_TIMER messages after every other message in 
your input queue is dispatched. For accurate timing, you really need to use the services provided by the 
Virtual Timer Device (VTD), functions tucked away in the multimedia extensions to Windows. These 
functions give you fairly high resolutions, but can be clumsy to use. Here’s a handy C+ + class that 
encapsulates VTD sen/ices to provide accurate timers. 

Mark Szamrej 

Managing Memory in Windows NT DLLs. 33 

The biggest hassle in Windows 3.x DLL programming is memory management, since you only get a single 
data segment rather than one per calling application instance. Windows NT offers solutions, not only for 
multiple processes, but for multiple threads within a single process. This article explores the six styles of 
Windows NT DLL memory allocation. 

Brian G. Myers 


Shareware Spotlight _ 

Visualib Makes 3-D Visualizations Easy.6 

Windows Graphics Device Interface (GDI) gives you 2-D, bitmapped graphics, but what if you need to 
create 3-D photorealistic effects, complete with textured surfaces and light source effects? Visualib is a 
shareware package that integrates these features on top of Windows GDI. 

Victor R. Volkman 


Book Review 


Windows Network Programming. 65 

by Ralph Davis. A network book for programmers that includes an implementation of an API layer that 
works on top of NetBIOS, Novell IPX/SPX, Banyan VINES Sockets, and the Windows Sockets API. 

Reviewed by Victor R. Volkman 
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Advanced. Serious. Technical. 

Columns 


Windows Questions and Answers. 47 

After revisiting a question about DdeCreateDataHandieQ, Paul looks at enabling the mouse cursor after 
Windows has already detected that no mouse is present. He discovers a bug in Program Manager that can 
leave the ShowCursorQ count off by one in this situation. Finally, Paul looks at the general problem of data 
validation in dialog boxes and shows a clean way to get the right icon displayed by Alt-Tab when your main 
window is a dialog. 

Paul Bonneau 

Practical C++: WUIMAN Object Definition. 59 

This installment of the WUIMAN (Windows User Interface MANager) series presents the declaration for 
AWuiObject, the class that defines the core functions of all WUIMAN objects. The column also discusses 
abstract classes and presents WUI MAN’S scheme for using cloning operations for all object creation. 

Ron Burk 

Tech Tips. 71 

Karl D. Schrey shows how to make Windows programming so simple that a child (specifically, his own 
children) can do it The never-ending saga of the best way to create a single-instance application continues, as 
Alex Vinogradov does it in four lines of code. Jim Lawless presents a utility to time program execution. Finally, 
Moshe Rubin points out a potential pitfall in depending on the _export keyword to do your exporting for you. 

Leor Zolman 
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Source Code Availability 


You can obtain source code for Windows/DOS Developer's Journal (including unpublished code) 
from: 

CompuServe - GO CLMFORUM, section 7; BIX/WIX - join listings, change area to “win.do.dev”; 
GEnie - in the Windows Roundtable at page 1335 (Keyword:Windows). 

USENET (Archived by UUNETTechnologies): uunet!~/published/windowsdos/19YY/monYY.zip 
Accessible via anonymous FTP from ftp.uu.net or via uucp from (900) GOT-SRCS (login name 
“uucp," no password, $.50 per minute). 

BBSs: 

Phoenix Chapter ACM Library - (602) 970-0474; 
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The Courts of Chaos — (501) 985-0059; 
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Cornerstone - (206) 362-4283; 
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Are you 1 
avoiding 
version 
control? J] 

Version control isn’t just for teams! 

If you've ever accidentally deleted 
source crucial to a project, or 
introduced a bug into working code, 
you know you need a version control 
system. Until now VCS’s have been 
expensive and notoriously difficult to 
maintain. Introducing Source Control: 
finally, individual programmers can 
track incremental code changes, just 
like large companies do for their most 
important projects! 

Think of it as object-oriented 
version control. 

Source Control’s "project orientation" 
will take full advantage of your object- 
oriented code by allowing you to share 
code among active projects. 

Developing for multiple platforms? 
Source Control is available now for DOS, 
Windows, NT, Macintosh, OS/2 and 
UNIX. All of these versions are 
transparent across a network so you 
can work with one integrated code base 
rather than managing time consuming, 
unnecessarily redundant systems. 

If you are part of a team... 

Source Control grows easily to meet the 
needs of team development. A single 
user can get started for less than $300 
(list price) and licenses are available in 
increments of five, ten and more. You 
can economically install Source Control 
on your server and get instant, 
project-wide status reports. Find out 
the who, what, where and when of each 
component as you speed your team to 
that final build deadline. 

Upgrade from PVCS! 

Make a quick transition from your 
current configuration management 
system with Source Control’s PVCS 
conversion utility. Add Powerline’s 
make utility, Source Make, and 
automatically update files without time 
consuming manual check-in/check-out 
procedures. Start on your way to a fully 
integrated configuration management 
system! 

Call for more information! 

Powerline Software is dedicated to 
providing a suite of compiler and 
platform independent developer's tools, 
including Source Print+, for source code 
management and Source View, the 
run-time debugger for C and C++. 


SOURCE CONTROL 

1 - 800 - 257-5773 


SOFTWARE INCORPORATED 


1306 Western Avenue, Suite 203, Seattle, WA 98101 
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From 

the Editor 


I would like to propose an end to the abuse of the acronym “API.” Although I was 
unable to trace the first use of the acronym (there’s never a Kelly-Bootle around 
when you need one), surely there is a consensus that “Application Program(ming) 
Interface" is what it represents. Usually, an API takes the form of a collection of 
(hopefully) related functions for communicating with some software or hardware 
entity. Therefore, MessageBox() is an API function, not an API. My concern with API 
abuse was sparked by a September 6 InfoWorld article claiming UNIX vendors had 
“agreed to make their products conform to a set of nearly 1,200 application 
programming interfaces (APIs).” I knew there was more than one flavor of UNIX, but I 
had no idea there were over a thousand! 

Meanwhile, Microsoft, en route to singlehandedly creating 1200 APIs for the PC, 
wants to abuse APIs in its own way. Companies such as Sun are working on offering 
their own implementation of the Windows API on other platforms. For everyone 
who doesn't live in Redmond, this is a Good Thing. It gives programmers a wider 
market for their applications and users the ability to get their favorite applications 
on their favorite platforms. Microsoft takes a different view of this development, 
however. The corporate chant of “Windows everywhere!" has been amended to 
“Windows everywhere that Microsoft sells or licenses it!" Uncowed by that pesky 
government investigation, Microsoft has been rattling its legal and public relations 
sabers at the Sun effort. 

I realize that it is heresy to suggest that the PC software industry learn anything 
from the lessons of mainframes and minicomputers, but maybe we could avoid 
repeating history just this once. For years, user groups asked for standardization 
among the various UNIX vendors. Each vendor then paid lip service to stand¬ 
ardization, while betting their resources that their vendor-specific solution would 
eventually dominate. Only the threat of Windows NT seems to have finally 
motivated a real mass movement toward standardization, but it may be too little, 
too late. UNIX and Windows programmers want the same thing: a single API that 
crosses hardware and operating system vendor lines, leveraging their development 
efforts to as wide a market as possible. The attempt to lock up the Windows API is 
an attempt to repeat the biggest mistake of UNIX history. The most money to be 
made for all concerned (including Microsoft) is to let a standard Windows API 
proliferate among vendors and platforms. C'mon, Microsoft — if you love the Win¬ 
dows API, set it free. 


Ron Burk 

Editor 

CIS: 70302,2566 ; BIX: rlburk ; Internet: ronbPrdpub.com ("... !uunet!rdpub!ronb") 
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Develop 

Windows Applications 
Quickly and Easily 


Phase3 Has Everything You Need 


Visual Development 

The Phase3 visual development environment 
provides a comprehensive suite of tools for 
screen creation. All standard Windows 
screen objects - push buttons, radio buttons, 
dialog boxes, etc. - are selectable from icon 
bars and are dynamically placed and sized 
on the screen as appropriate for the 
application. Standard Windows APIs are 
available from list boxes and are supported 
with on-line documentation. 


Phase3 Database 

Phase3 includes a relationally complete 
database supplied as a Windows DLL. The 
database supports complex data relation¬ 
ships and access and data manipulation by 
any language through a comprehensive 
suite of supplied database routines. 
Database integrity is enhanced with 
rollback recovery and transaction control. 
The Phase3 data dictionary simplifies data 
model definition and maintenance. 


Query and Reporting 

The Report Writer includes standard 
features like flexible headers, footers, free 
text, calculated fields, sort group sections 
and breaks, and subtotals. Reports can also 
include bitmaps of drawings and photo¬ 
graphic images. Queries are executed with 
the Database Browser which also allows 
data entry and manipulation. Railway 
diagrams assist in query creation, prompt¬ 
ing the user for appropriate selections and 
eliminating syntactical errors. 



Royalty-Free Applications 

Windows is a trademark of Microsoft Corporation. Turbo Pascal 
for Windows and Borland Pascal 7.0 are trademarks of Borland 
International, Inc. All other trademarks or service marks are 
recognized as the property of their respective owners. 


Lower CASE, E-R Modeling 

Phase3 automates logical data model design 
with Entity-Relationship modeling. After a 
user describes entity relationships graphi¬ 
cally and enters field descriptions, Phase3 
generates the physical database based on an 
analysis of the entity relationships. Phase3 
automatically includes foreign keys in 
appropriate tables and restructures the 
database as requirements change. Phase3 
suggests appropriate referential integrity 
constraints to be enforced at runtime. 


Hierarchy Chart 

Phase3 maintains a graphical map of an entire 
application. The Hierarchy Chart includes all 
windows, dialogs, reports, and code routines. 
To access the underlying C or Pascal source 
code, simply point-and-click on any node. 
Phase3 generated source is easily accessed 
and extended with user written routines. User 
code is preserved even if an application is 
regenerated. The Hierarchy Chart and E-R 
Diagram provide instant core documentation 
for an application. 


Help Generator 

The Phase3 Help Generator allows the easy 
creation of a complete Windows application 
help subsystem including context sensitive 
on-line help. The Help Generator includes its 
own text editor that gives complete control 
over the content, appearance, and branching 
logic through highlighted trigger text. Phase3 
generates a Windows compatible file with an 
“.HLP” extension that is then accessible 
from within the Phase3 created application. 
No other external tools are required. 


"... a thoroughly remarkable product... 
very impressive” 

Jeff Duntemann 

PC Techniques 

AAA 

“I was very impressed with Phase3, and using it 
made me wish I had learned Windows programming 
with a tool like this. Now that I know what it has to 
offer, I’ll probably use it to build the frame for most 
of my programs.” 

L. John Ribar 

Windows Tech Journal 

AAA 

“Phase3 hides the complexity of Windows program¬ 
ming but still allows an experienced programmer to 
drill down and extend generated C or Pascal source 
code, providing ultimate control.” 

Randy Goodhew 

Computer Software Columnist 

AAA 

“Phase3 takes an intuitive, innovative approach to 
developing Windows applications. It’s a pleasure to 
work with and has greatly boosted our productivity. 
One of the most important issues for us is that their 
technical support is excellent.” 

Reuben Halevi 

ISoft D&M 

AAA 

“It’s easy to put together an application with Phase3 
- everything's integrated. And the Phase3 database 
is terrific. It’s closer to true relational than anything 
we’ve found.” 

Michael Erickson 

Prism Business Solutions 

lot 



Order Now 

800 - 851-5650 

Or Call for Free Demo Disk 
Fax (805) 641-9083 


CALL NOW FOR COMPETITIVE UPGRADE PRICING 


0 
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■ Shareware Spotlight 


Visualib Makes 3-D Visualizations Easy 


Victor R. Volkman 


Visualib, by Visual Tech (Fort Wayne, IN), is a 2-D and 3-D 
graphics rendering and transformation library for Windows. 
Visualib renders graphics expressible by lines, curves, and sur¬ 
faces in floating-point world coordinates. It complements the 
Windows Graphical Device Interface (GDI), which is oriented 
toward discrete two-dimensional bitmaps. Visualib supports 
multiple 2-D and 3-D viewers with double-buffer animation. 
Visualib also includes lighting, shading, solid texture, and 
image mapping for photorealistic effects. Visualib can even 
render TrueType fonts in 3-D space and apply all visual at¬ 
tributes (shading, for example) to them as well. 

Visual Tech supplies both DOS and Windows 3.x libraries, 
visual Tech currently distributes two versions of the library for 
the Windows environment: Visualib 1.x and 2.0. Since Visualib 
1.x is distributed as an object library (.lib) rather than a 
dynamic link library (.dll), you must use one of the sup¬ 
ported compilers. Currently, Visualib 1.x supports Microsoft C 
6.0 (or later) and Borland Turbo C/C++ version 2.0 (or later). The 
evaluation version I received provided only a Borland library. 

Visual Tech distributes Visualib 2.0 as a set of Windows 
DLLs that work with any language that can call DLL functions 
(C, C++, Pascal, Visual Basic, and so on). Further, Visualib 2.0 
includes the shading, surface detail, and TrueType font support 
that are excluded from Visualib 1.x. Since Visualib 2.0 is over 
$300 more expensive, many developers may opt to start with 
Visualib 1.x. 

Coordinate Systems 

You can think of Visualib as an extension of the Windows 
Graphical Device Interface (GDI). Rather than replacing GDI, 
Visualib provides an additional way to render objects. Visualib 
uses its own world coordinate system instead of GDI coor¬ 
dinates, and Visualib applications map viewers directly to 
device context handles (hDCs). 


Like most high-level graphics libraries, Visualib operates in 
floating-point world coordinates rather than pixels. Your ap¬ 
plication can control how Visualib maps its world coordinate 
system onto the screen, using the SetView3D() function (for 
rectangular coordinates) or the SetPolarView3d() function (for 
polar coordinates) to locate the viewer, and then using Set- 
Perspective () or SetProjection3D() to map the projection 
onto the output device. 

All coordinates used to specify objects in 2-D or 3-D space 
are actually homogeneous coordinates. Homogeneous coor¬ 
dinate systems allow translation (movement), scaling, and 
rotation to be expressed by matrix multiplication. In a non- 
homogeneous coordinate system, you must specify translation 
by matrix addition rather than multiplication. Homogeneous 
coordinates require an extra parameter such that a point (x,y) 
can be expressed as P(W*x, W*y, W) (for more information, 
see Foley and Van Dam 1984, p. 670 ff). Fortunately, Visualib 
provides two functions to map from non-homogeneous to 
homogeneous coordinates: AssignPoint2D() and Assign- 
Point3d(). 

Viewers and Drawing Functions 

Visualib can establish any number of 2-D and 3-D viewers 
with independent eye position, projection, and volume 
parameters. It supports the standard linear transformations of 
rotation, translation, and scaling for 2-D and 3-D geometric 
models. Visualib provides a 2-D and 3-D transformation matrix 
stack that allows you to implement hierarchical geometry. 

Visualib supports a full complement of 2-D and 3-D draw¬ 
ing functions (Figures la, lb, and ic list a subset of these 
functions) for lines, polygons, ellipses, spheres, and polyhedra. 
The 3-D viewers can optionally have backface culling (a.k.a. 
hidden-line removal) (see Figure 2 for an example). The hidden 
surface removal is implemented via the depth-buffer method. 
Visualib also provides curve and surface line-drawing functions 


Victor R. Volkman received a BS in Computer Science from Michigan Technological University. He has been a contributing editor for 
Windows/DOS Developer's Journal since 1990. He is currently employed as Senior Analyst at H.C.I.A in Ann Arbor, Michigan. He can 
be reached by dial-in at the HAL 9000 BBS (313) 663-4173 or by Usenet mail to sysop@hal9k.com . 
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such as Bezier, Hermit curves, B-Spline, NURBS curves, and sur¬ 
faces. 

You can use Visualib in any type of Windows device con¬ 
text: screens, printers, or memory, visualib uses whatever 
drawing attributes (such as colors, line width, and so on) are 
currently in effect in the GDI device context. 

Double Buffering 

Smooth animation usually requires double-buffering: the 
drawing takes place in a memory buffer which is then copied 
to the screen en masse, so the user sees entire frame chan¬ 
ges rather than individual lines and surfaces being drawn. 
Each Visualib viewer can have its own double-buffer area. 
Here is an example of a short animation sequence with a 2-D 
rotation in a double-buffer: 

BeginDoubleBuffer(&hdc, viewer21); 
SelectViewer(viewer21); 
for (i =0; i <10; i ++) { 

ClearViewer2D(hdc, viewer21, WVGRAY); 
NsideFlower2D(hdc, 0, 0, 6, 4.5, 10); 

Rotate2D (6); 

UpdateDoubleBuffer(hdc, viewer21); 

} 

EndDoubleBuffer(&hdc, viewer21); 

First, the call to BeginDoubleBuffer2D() tells Visualib to allocate 
a buffer big enough to fit the device context and viewer. Note 
that the example explicitly clears the buffer between drawing 
iterations. Otherwise, the buffer would continue to accumulate 
more objects. The call to UpdateDoubleBufferQ actually causes 
Visualib to render the buffer into the Windows device context. 
Last, the call to EndDoubleBuffer() means that all future draw¬ 
ing functions will write immediately to the device. 

Writing to the buffer is actually faster than writing to the 
screen via Windows. Also, since each redraw of an animation 
usually involves multiple changes, the double-buffer serves as 
a batching mechanism for this. You could use a Windows 
timer to provide a timed refresh rate for your animation. 

Lighting Models 

Visualib renders graphics objects with a sophisticated light¬ 
ing and shading system (for a complete explanation of lighting 
and shading models, see Foley and Van Dam, 1984). Your ap¬ 


plication can create an unlimited number of lights, and you 
can individually set each light characteristic, such as position, 
direction, color, intensity. Each light can be turned on or off at 
any time. The following example creates a spotlight effect: 

(continued on page 8) 


Product Information 


Visualib (MSC, Borland C++, others) 

Visual Tech, Co. 

P.O. Box 901-413 
Kansas City, MO 64190 
Tel. (219)489-0235 
Fax: (816) 746-6618 


Evaluation Period: 45 days 
How to get Visualib: 

• By anonymous FTP from the Center for Innovative Com¬ 
puting Applications (CICA) at the University of Indiana. 

"ftp ftp.cica.indiana.edu 

cd /pub/pc/win3/programr 

get “vllibbczip" (Visualib 1.x / Borland C++ version) 

get “visualib.zip" (Visualib 2.0 DLL) 

• Download from the HAL 9000 BBS at (313)663-4173 or 
663-3959. Speeds from 1200 to 14400 baud supported. 

“d vlibbczip (Visualib 1.x / Borland C++ version) 

To get Visualib 2.0 evaluation copy: please contact 
Visual Tech directly. 

Registration: (each version includes unlimited runtime) 

• Visualib 2.0 for Windows (DLL) $399 

Visualib 1.x for Windows (MS C) $50 
Visualib 1.x for Windows (B C++) $50 
Visualib 1.x for DOS (MS C) $40 

Visualib 1.x for DOS (B C++) $40 

Visualib 1.x source code $300 

*To redistribute Visualib 2.0 DLL, you need a resaler 
registration. 







Iight4 = CreateLight (NULL, 
VL_SPOTLIGHT); 

VSET3 (vector, 0, 0, 100); 
ShadingParameter (light4, 

VL_LIGHTLOCATION, FALSE, vector); 
VSET3 (vector, 0, 0, 1); 
ShadingParameter (light4, 

VL_LIGHTDIRECTION, FALSE, vector); 
ShadingFactor (light4, 
VL_SPOTLIGHTANGLE, 10); 
ShadingFactor (light4, 

VL_SPOTLIGHTSPREAD, 50); 
ShadingColor (light4, 


VL_LIGHTC0L0R, RGB (51, 255, 51)); 
SwitchLight (light4, TRUE); 

CreateLight() initializes the light ob¬ 
ject and returns a light handle for use 
with subsequent functions. Shading- 
Parameter() is called twice: once to set 
the light’s position in 3-D space and 
again to set its direction. The spotlight 
angle and spread factors also affect 
shading. ShadingColor() selects the 
color of the light hitting the surface. 
Last, SwitchLight() enables this light 
to affect rendering. 


Visualib supports three basic types 
of lights: spotlights, point lights, and dis¬ 
tance lights. A spotlight is a narrow 
cone shape projection of light, such as 
you would see in a real theater. A point 
light is a single source that transmits 
light from one point to all directions — 
for example, an unshielded incandes¬ 
cent bulb. A distance light projects light 
from far away, as, for example, fluores¬ 
cent lights or stadium-style arc lights, in 
addition, Visualib can handle the in¬ 
fluence of ambient light, which is a 
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Unsupported compression scheme 
D Compressed BMP images are not currently supported. 
The graphics filter was unable to convert this file. 

(Actual messages from 3 competing libraries) 

Who ya gonna call? 


o 


When your customers call about files that won't read into your application, 
only AccuSoft GUARANTEES to read all images in existence! 

AccuSoft Image Format Library 4.0 


TIFF 


PCX 


JPEG 


TGA 




Vfl/f 


♦Fastest library on the market! 

♦Highest quality imaging library! 

♦No royalties whatsoever! 

v Super-fast Group 3, Group 4 and JPEG support, 
v Also supports non-standard G3 and G4 formats. 

V Scanning supported including TWAIN. 

V Display effects including fades, blocks, wipes etc. 

V Complete image processing: zoom, pan, scroll, rotate, 
gamma correction, brightness, contrast, sharpness, 
dithering, matrix filters, edge detection etc. 

V Extensive color reduction and conversion. 

V High-speed, high quality display for all modes. 

v High-level interface, 1 function handles all 12 formats. 

V Low-level interface, read & write 1 line at a time. 

V Memory to memory read & write. 

V Call for complete details by FAX. 

Image Format Library /DOS $495 Image Format Library /WIN $495 

Image Format Library /VBX $495 Image Format Library /VBX32 $995 

Image Format Library /NT $995 Image Format Library /OS2 $995 

Ultra-fast 32 bit versions also available. 

Call (800) 525-3577 

Ask About our 30 minute delivery program! 


Format Compatibility Goaraatood! 
(Roads all images - poriod) 
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GIF 


PICT 


High Performance Imaging 

AccuSoft Corporation 112 Turnpike Road Westborough MA 01581 (508)898-2770 (508) 898-9662 (FAX) 
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constant illumination level from all 
directions. 

Shading and Materials 

Visualib provides shading in wire¬ 
frame, solid fill, flat, Gouraud, and Phong 
methods. Visualib 1.x supports only the 
wire-frame method. If you select the 
Phong method, you can choose either 
Phong model or specular reflection 
model shading. For example, the follow¬ 
ing sets Phong shading method and 
specular reflection model. 

ShadingOption (VL_CURRENT, 
VL_SHADINGMETHOD, VL_PHONGSHADE); 
ShadingOption (VL_CURRENT, 

VL_SHADINGMODEL, VL_SPECULARMODEL); 

Gouraud shading, also known as inten¬ 
sity interpolation shading, eliminates in¬ 
tensity discontinuities in rendering. The 
Phong model approximates specular 
reflection by taking into account the 
angle between the direction of reflec¬ 
tion and the viewpoint. Specular reflec¬ 
tion is simply the reflection seen on any 
shiny surface, such as an apple. 


In Visualib, shading methods help 
define how materials will look. The 
material of the object you’re drawing 
also has physical characteristics that in¬ 
teract with the shading. You can set the 
reflectivity and shininess of any 
material once you have instantiated it 
by calling CreateMaterial (). 

Image Mapping and Solid 
Texture 

In addition to defining shading be¬ 
havior and material characteristics, you 
can also define image mapping or tex¬ 
ture mapping for rendering. Image map¬ 
ping means that the colors of the 
materia] surface are based on an ar¬ 
bitrary bitmap. Visualib easily turns any 
Device Independent Bitmap (DIB) into a 
2-D or 3-D image map. Visualib provides 
direct support only for Windows bitmap 
(.bmp) files, although any file format 
that your application can fetch into a 
DIB will work too. The following ex¬ 
ample shows a bitmap of a dragon 
used for image mapping: 



DIG for Windows 


New Improved Version 


WAKE UP to the possibilities of 
advanced scientific graphics in your 
own software. Save years of 
programming time and effort. 


Get full source code for advanced 
graphics without paying any royalties. 
Do not get in the position of negotiating 
- royalties after spending the time to 
2 learn and incorporate a graphics 
# library into your program. 


NO ROYALTIES 


Get powerful and robust source code 
that is easy to understand and modify. 
Write to any windows device context, 
including windows, printers, icons, 
bitmaps and metafiles. 


FULL SOURCE 
ALL for $499.00 


Get all the advanced graphics that you 
want like xy plots, solid or wireframe 
surfaces with height color coded and 
solid or labeled line contours. 


Call (619) 632-9510 & Order It. 

rilJTU D Technical 
V^XlXxVX Services 

P.O. Box 551, Del Mar, CA 9 2 0 1 4 


Windows & DOS 



Creates commented source code and list¬ 
ings from binary files. Shows how programs 
work with detailed comments on interrupts, 
subfunctions, I/O functions, and more. Sup¬ 
ports all instructions to 80486 and V20/V30. 


Sourcer provides the best analysis separat¬ 
ing code and data. It automatically deter¬ 
mines data types, uses descriptive labels for 
BIOS and PSP data, and links data items 
across multiple segments. 

New version 5.0 makes most DOS EXE and 
COM files and drivers reassemble perfectly, 
byte-for-byte identical to the original! 

Top professionals depend on Sourcer for the 
most reliable results with the least effort. 




for windows 


"Sourcer combined with Windows 
Source should be mandatory for 
looking into Windows Programs." 
Sal Ricciardi PC Magazine 


Windows Source™ with Sourcer generates 
detailed listings of Windows EXEs, DLLs, 
SYSs, VxDs, device drivers & OS/2 NE files. 
Labels, by name, export & import function 
calls, API calls like "GetFreeSpace" and more. 

See the many undocumented Windows 
functions used by professionals to perform 
tricks that are otherwise impossible. 


Comes complete with extra utilities for 
resource extraction and import analysis. 
Uses CodeView symbols for improved clarity. 


BIOS Source 


for PS/2, AT, XT, PC and Clones 

The BIOS Pre-Processor ™ with Sourcer 
creates commented listings for any BIOS 
ROM in your PC. Understand how your 
specific BIOS works! Adds over 75K of 
comments specific to your BIOS. Identifies 
multiple interrupt branches with special 
labeling like "int_10_video." Fully automatic. 

Sourcer-Commenting Disassembler $129.95 
Sourcer w/BIOS -(save $10) 169.95 

ASMtool 486 -Automatic flowcharter 199.95 
ASM Checker -Finds source code bugs 99.95 
Windows Source-requires Sourcer 129.95 
Windows Source & Sourcer-(save $30) 229.90 

Shipping: USA $6; Canada/Mexico $10; Other $18. CA 
residents add sales tax. © 1993 VISA/MasterCard/COD 

30-DAY MONEY-BACK GUARANTEE 

1 - 800 - 648-8266 order desk 

V Communications, Inc. 

4320 Stevens Creek Blvd., Suite 275-WD 
San Jose. CA 95129 FAX 408-296-4441 
408-296-4224 
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ReadDIB ("dragon.bmp", &hdibl); 
SelectViewer (viewer30); 

Seale3D (20, 20, 30); 
poi nt [0] = -1; poi nt [1] = -1; 
point[2] = 1; point[3] = 1; 
point[4] = -1; point[5] = 1; 
point[6] = 1; point[7] = 1; 


point[8] = 1; point[9] = -1; 
point[10] = 1; point [11] = 1; 

ImageMap3D (hdc, hdibl, VL_3D, point); 

ReadDIB() converts the .bmp file into an in-memory DIB struc¬ 
ture. Next, the code selects viewer30 as the default viewer for 
all subsequent rendering operations. The “point” array actually 
contains three points defining a solid region in which this 
image mapping is valid. In this case, the cube of (-f,-f,-f) to 
(1,-1,1) to (-1,1,1) is affected. A given viewer can thus be parti¬ 
tioned to accommodate any number of image maps. 

Solid texture accounts for the fact that few surfaces are 
totally smooth in the real world. Texture represents the coar¬ 
seness, bumps, and recurring patterns ingrained in the surface 
(you can think of texture as a bumpy wallpaper that gets 
pasted onto the surface you're modeling). Visualibe allows ad¬ 
vanced programmers to develop their own shaders. The man¬ 
ner is very similar to Pixar's RenderMan. Since defining your 
texture would be a very complicated process, Visualib 
provides predefined textures. Currently, only null (smooth), 
granite, woodgrain, and marble are supported. Figure 3 shows 
a toroid (doughnut) rendered with marble texture. 

2-D and 3-D Text 

Visualib can render any TrueType font with the all of the 
previously described visualization effects, including image 
mapping and texture, as well as all the translation, scaling, 
and rotation transformations. Figure 4 shows an example of 


MultiLinl# for Windows is a Grand Slam for 
Connectivity Programming in Windows 


Whether as a programming tool or as a platform for 
developing connectivity solutions for your clients, MultiLink 
for Windows is a whole new ball game. 

MultiUnk for Windows takes advantage of Microsoft® 
Windows' multitasking to provide multiuser capabilities on 
the Windows PC. This means that up to eight users (more 
in some situations) can actually share the CPU to run DOS 
applications from a 
terminal, workstation 
or PC emulating a 
terminal while the 
host Windows PC 
remains active and in 
use. Users sharing 
the PC can be local (in 
the same office) or 
remote (dialing in via 
modem from another 
office or another city). 

First a Programmer's Tool 

MultiLink for Windows lets you view the Windows desktop 
while programming in a DOS box . You can write or debug 
code from the DOS session at a terminal while watching the 
results on the Windows PC at your side. This means no 
more exiting your Windows session or switching to an 
inactive task. 



Second a Support Tool 

If you need to provide technical support or programming services to a 
client in another location, you can use MultiUnk for Windows to access the 
system as a remote user via modem and terminal emulation to debug 
code or check configurations from your home or office. 

Third a Flexible Platform Choice for Development 
MultiUnk for Windows is a flexible alternative to networking that 
provides fast, simple connectivity versus the com¬ 
plexity of a LAN. One example is the point-of-sale 
environment, where retail terminals may not require 
graphics, but back-office managers may wish to use 
Windows for data analysis or monitoring. The oppor¬ 
tunities for unique and exciting applications are endless. 
Score with a Winning Alternative 
MultiLink for Windows is a whole new ball game in 
affordability, ease-of-use, ease-of-development and 
connectivity. It is a tool for transition from the 
DOS standard to the Windows environment. It is a 
connectivity tool for sharing information and 
equipment without a network. Call The 
Software Link and get in the game. 

| THE SOFTWARE LINK 

Creating Unbeatable 
Connectivity Solutions 

Call (404) 512-0705 

Fax (404) 512-7005 


MultiLink is a registered trademark of The Software Link. Microsoft is a registered trademark of Microsoft Corporation. Price, policies and 
specifications subject to change without notice. © Copyright 1993 The Software Link, Inc. 5575B Chamblee-Dunwoody Road, Suite 205, 
Atlanta, Georgia 30338 USA. Phone (404) 512-0705. Fax (404) 512-7005. 
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such rendering with the Script font. The following example 
demonstrates how easily the effects can be combined: 

SelectViewer (viewer30); 

SetFont(lpLogFont); 

ClearDepthBuffer (Oxffff); 

TextParameter (VL_TEXT_HEIGHT, 40); 

TextParameter (VL_TEXT_THICKNESS, 8); 

SelectMaterial (materO); 

ShadingOption (VL_CURRENT, VL_DEPTHBUFFER, TRUE); 
PushTransformation3D (NULL); 

Rotate3D (135, 'z'); 

Rotate3D (90, 'x'); 

Translate3D (-60, 0, 0); 

DrawString (hdc, "Visualib \n 
Advanced \n Technology", 

VL_S0LIDTEXT); 

PopTransformation3D (NULL); 

The Set Font () call sets the default 
TrueType font for the current viewer. 

TextParameter() can set both the 
height and thickness (depth) of the text 
to be drawn. Finally, DrawString () ac¬ 
tually displays the text in the context of 
the current translation, rotation, and 
scaling. Alternately, DrawVertical- 
StringO can draw the text from top- 
to-bottom rather than left-to-right. 

Documentation 

The documentation consists mainly 
of the visualib.hip Windows help file 
plus assorted header files and a 
demonstration program. The organiza¬ 
tion of the help file allows it to serve as 
a handy reference. The authors have 
nested information in easy-to-use links 
with plenty of cross-references. 

However, the help file does not con¬ 
tain a tutorial and relies mainly on your 
ability to study and understand the 
demonstration program. Also, the com¬ 
plete omission of any embedded pic¬ 
tures to illustrate graphical concepts 
severely limits usability. Developers 
without formal education in computer- 
assisted 3-D visualization may en¬ 
counter difficulty. 

Support, Licensing, and 
Registration 

Visual Tech provides technical sup¬ 
port primarily by telephone. As of this 
writing, support by email is not yet 
available. Registered users may obtain 
technical support for an unlimited time. 

Non-registered users are granted a 
limited license of 45 days to use 
Visualib on a trial basis for the purpose 
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of evaluation and determining if Visualib is suitable for their 
needs. Any other use of the product requires registration. The 
evaluation version displays this license information the first 
time your application invokes the Visualib library. Once 
registered, you may distribute unlimited runtime copies of the 
1.x library as necessary. Three types of licensing arrangements 
are available for Visualib 2.0: single user, multi-user, and reseller. 
To distribute Visualib.dll with your product, you must pur¬ 
chase the reseller license. The README. 1ST file provided with the 
2.0 evaluation copy contains licensing information. 

Conclusion 

Visualib, by Visual Tech, offers a 2-D and 3-D visualization 
library that is both flexible and simple to use. Visualib works 
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Create, edit, and test help quickly 
in an integrated environment! 



... that you might even want to 
use it as a hypertext authoring 
tool, independent of providing 
help for a product. Certainly for 
Windows programmers it's 
indispensable."! - July 1993 
Toolkits section 


Windows Magazine gave the 
Help Magician an "A" for 
creating help files interactively. 


Some original features 

□ Built-in full-featured editor 

□ Create jumps and popups 

□ Create multiple hot spots 

□ Include bitmaps 

□ Create bulleted or numbered lists 

□ Create browse sequences 

□ Use various font styles and colors 

□ Test help files instantly 

□ Quickly writes RTF files 

□ Imports MS Word’s RTF files 

□ Extensive error & syntax checking 

□ Works with any Windows language 
including Visual BASIC and C 


Some version 2.0 features 

□ No memory limitations 

□ Secondary windows 

□ Non-scrolling regions 

□ Set background colors 

□ Advanced paragraph 
formatting 

□ Full macro support 

□ Jump to other help files 

□ Multiple file support 

□ Help window sizing and 
positioning 

□ Built-in spell checker 

□ Writes #define files 


Our competitors require Microsoft Word and use a series of macros, a 
slow process. The Help Magician is a fast, full-blown Windows 
application. One major competitor charges $150/yr for tech support; we 
don't. Simply put, the Help Magician is the best help authoring tool 
money can buy! SITE and Network licensing available. 
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well in tandem with Windows’ own GDI interface. Visualib 
provides a powerful library of 2-D and 3-D drawing primitives. 
These primitives form the skeleton on which layers of shading, 
texture, and material can be applied. Sophisticated lighting 
control completes the suite of functionality. Although 
visualization graphics traditionally resides in esoteric areas of 
scientific and engineering modeling, Visualib makes it possible 
for any application. 


Bibliography 

Foley, James D., and Andries Van Dam. 1984. Fundamentals of 
Interactive Computer Graphics. Reading, MA: Addison-Wesiey. 
This work represents one of the most comprehensive and 
highly technical surveys of computer graphics. It is both a 
reference and a tutorial for many aspects, including light¬ 
ing, shading, texture, and other methods of portraying 
realism. □ 


Graphics & Timing Tools 


BGI Printer Driver Toolkit provides drivers for Borland's 
BGI graphics library to support a wide variety of printers, plotters, 
and DTP file formats. Extensive color device support. Not a 
screen dump - load our drivers with BGI’s initgraph and get full 
output device resolution. Supports Borland DOS language 
compilers, drivers for real and protected mode included See 
review in Aug ‘93 PC Magazine, page 77. $129.95 w/source. 

BGI For Windows gives you an interface to the Windows 
3.x GDI compatible with Borland BGI graphics calls. Port your 
DOS BGI graphics code effortlessly to windows. Full support for 
256 color palettes, BGI stroke fonts, high resolution displays, and 
rasterized hardcopy. BGI extensions support TrueType and 
TrueColor. Supports Borland Windows language compilers. 
$129.95 w/source. 

PC Timer Tools brings microsecond resolution timing to 
your DOS application with extensive functions for timers, delays, 
alarms, timer tick management, and thread scheduling. Ideal for 
execution profiling, data acquisition, and process control. 
Supports Borland DOS compilers, MSC/C++, Intel 386 CB, 
Zortech, $89.95 w/source. 

PC Timer Objects gives you the power of PC Timer Tools 
using C++ classes and Turbo Pascal methods. Now implement 
precise timing and thread scheduling using the latest OOP 
techniques. Supports Borland C++, Turbo Pascal OOP, Zortech 
C++, MSC++. $89.95 w/source. 

All toolkits include complete source, object/driver 
distribution license, and our 30 day "No Questions Asked" return 
policy. Add $5 shipping USA, $10 elsewhere. VISA and 
MasterCard accepted. Join the thousands of satisfied developers 
and users worldwide and order today! 

Ryle Design 

Purveyors of Big Science since 1987 

PO Box 22, Mt. Pleasant, Ml 48804 USA 
Voice/Fax: 517.773.0587 CIS: 73047,1765 
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Software Developers... 

Ask Corel, AT&T, 

EXXON, Sharp, 

Inset Systems, and 
a thousand 
others... 

why they picked 
LEADTOOLS for 
their image 
application. 

They'll say from 
document to true color 
imaging. LEAD Technologies is innovative. 

LEAD pioneered image compression technology that 
achieves compression ratios of over 200 to 1, 
constructed tools for quick integration of images into 
any application, and built a toolkit with a reputation for 
speed! Call for a free evaluation diskette to see for 
yourself. 

LEAD Technologies, Inc. 
1-800-637-4699 • Fax 704-548-8161 
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Networks 


Network Programming 
and Visual Basic 

Lee Wiltbank 

When I first opened the Visual Basic package and installed it on my computer, I 
saw a tool that would get me started on some serious Windows programming 
quickly. Within minutes, I was creating fairly sophisticated Windows applications. 
Being an inquisitive software engineer, I immediately began to wonder if 1 could use 
it to make a network application . The answer turns out to be yes, but not without 
some custom control programming. 

Programming for networks under Windows presents some interesting challenges. 
The complications arise because calls to almost any network protocol can be desig¬ 
nated as synchronous (wait for a response) or asynchronous (proceed without wait¬ 
ing for a response). Synchronous network calls are generally undesirable in Windows, 
because a call can take an indeterminate amount of time to complete, making the 
machine appear to be hung. In a Windows C program, you typically handle 
asynchronous events by giving the network functions either a handle to a window 
or a pointer to a function to be invoked when a network event occurs. When the 
asynchronous network request completes, the network software sends a message 
to the window procedure or invokes the callback function, which then processes the 
message. 

Sounds simple enough, but how can you do this in Visual Basic? Try as 1 might, I 
could not get Visual Basic to handle a callback of any sort. My solution was to write 
a network custom control that handles the asynchronous messages and then 
provides events to Visual Basic. Because of the event-driven nature of Visual Basic, 
this proved to be an elegant solution to sticky problem. This article discusses some 
of the issues involved in creating and using a network custom control for Visual 
Basic. You can get the complete custom control and source code, along with a 
demonstration program written in Visual Basic, from the sites listed on the table of 
contents page (under "Source Code Availability'’). 

General Concepts 

I designed a custom control to handle the IPX/SPX protocols, the protocols that 
Novell NetWare uses. Currently, the control does not handle SPX packets. Because 
many of the concepts and techniques used to send IPX packets are shared with SPX, 
you could extend the custom control to handle SPX. 

IPX (Internetwork Packet Exchange) protocol is a datagram (connectionless) service 
corresponding to the network level of OSI. IPX establishes no connections nor 
guarantee of packet delivery. Each packet a workstation sends is treated separately. 
SPX (Sequenced Packet Exchange) is a connection-oriented protocol providing guaran¬ 
teed packet delivery, flow control, and sequencing. SPX has many of the charac¬ 
teristics of the transport level of OSI. IPX/SPX are adaptations of protocols developed 
by Xerox and implemented in the Xerox Network System (XNS). All multiple-byte 
fields in an IPX packet use the big-endian (most significant bytes come first) format 
because of the dependence of IPX/SPX to XNS. 


Lee wiltbank is a software engineer at a major software firm, specializing in network¬ 
ing and data encryption. He can be reached on CompuServe at: 71776,1274. 
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Addresses 

To actually use these protocols, you must be familiar with 
IPX/SPX addresses and event control blocks (ECBs). A C struc¬ 
ture representing IPX addresses looks like this: 

typedef struct IPXAddress 

{ 

BYTE network[4]; /* high-low */ 

BYTE node[6]; /* high-low */ 

BYTE socket[2]; /* high-low */ 

}IPXAddress; 

The network address specifies the network segment that the 
workstation resides on. The node address identifies the 
specific workstation on that segment. The node address is 
derived from the network interface card and uniquely 
specifies each card. The socket acts like a window from the 
network to a process on a workstation. To receive data, you 
must first open a socket. IPX does not require you to open a 
socket to send packets, but SPX does. To send a packet, 
specify the destination by its node, network, and socket in an 
IPXAddress structure. 

Before opening any sockets, however, you will first need to 
initialize IPX with a call to IPXInitialize(): 


to IPX. maxPacketSize is the maximum packet size that the 
application can send, and defaults to 576 bytes. If the in¬ 
itialization is successful, IPXInitialize() sets IPXTaskld to a 
task ID that you will pass to other IPX/SPX functions. 

After initializing IPX, you can then open a socket. Since a 
socket is a two-byte quantity, socket numbers can range from 
OOOOh to FFFFh. Novell and Xerox have reserved some of this 
range. For example, the NetWare shell uses socket 451h to 
make NetWare Core Protocol (NCP) requests, while 452h is 
used for Server Advertising Protocol (SAP). Novell reserves the 
range from 4000h to 8000h for dynamic sockets that 
developers can use as they wish. Socket numbers assigned by 
Novell begin at 8000h. In my sample program, I use socket 
5454h. To open the next available dynamic socket, pass zero 
as the value for the socket. 

When opening a socket, you can open it as long- or short¬ 
lived. Long-lived means that you must explicitly close the 
socket before your application terminates. Short-lived sockets 
will be closed automatically when the application terminates. 
In Windows, all sockets should be long-lived and explicitly 
closed by the application. Opening a socket involves calling 
IPXOpenSocket() with the IPXTaskID supplied by 
IPXInitializef) , along with a pointer to a word and a 
socketType: 


ccode = IPXInitialize(&IPXTaskID, maxECBs, maxPacketSize); 


maxECBs is the maximum number of event control blocks 
(ECBs are described in more detail later) that can be submitted 
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Socket = 0x5454; 

ccode = IPXOpenSocket(IPXTaskID&Socket, L0NG_LIVED); 

In this call, I am opening socket 5454h to be long-lived. 
Remember that the multiple-byte quantities are in big-endian 
format. If you want to open socket 5000h, you need to assign 
0050h to the variable Socket. 

Event Control Blocks 

The event control block (ECB) contains the information IPX 
needs to send or receive a packet. When you want to send or 
receive a packet, set the appropriate fields in the ECB and turn 
it over to IPX. Figure 1 shows C structures for an ECB and 
ECBFragment. The ECB is never transmitted across the net¬ 
work; rather it gives directions and memory buffers to IPX to 
complete a network operation. fragmentDescriptor[0] and 
fragmentDescriptor[l] point to data coming in or going out 
on the wire. The most difficult part of using IPX is setting up 
ECBs, as I will describe in detail. 

IPX uses the linkAddress field of the ECB internally to 
queue up the ECBs for a particular socket. The ESRAddress 
contains a pointer to a callback function or event service 
routine (ESR), which will be invoked in response to an IPX 
event. While IPX is using the ECB, the inUseFlag will be set to 
a non-zero value. When a network event occurs, IPX sets in¬ 
UseFlag to zero, enters the appropriate value in the 
completionCode, and then calls the event service routine 
specified in ESRAddress. The fragmentCount field contains the 
number of ECBFragments that IPX should look for; you can 
use as many fragments as you wish. The first 30 bytes of the 
first buffer must contain an IPX header (described next). I like 
to use two fragments: the first fragment for the IPX header, 
the second fragment for data. 
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An IPXHeader looks like this: 

typedef struct IPXHeader 

{ 

WORD checksum; /* high-low */ 

WORD length; /* high-low */ 

BYTE transportControl; 

BYTE packetType; 

IPXAddress destination; 

IPXAddress source; 

}IPXHeader; 

An IPXHeader contains the source and destination address for 
the IPX packet. The checksum and transportControl fields 
will be filled in by IPX. You should set the packetType field to 
4 for IPX and to 5 for SPX. When sending a packet, fill in the 
destination field with the network, node, and socket of the 
destination workstation to communicate with. When you 
receive a packet, the length field will contain the length of 
the entire packet received by IPX, in big-endian format. The 
source field will contain the address of the sending worksta¬ 
tion. 

Handling the Packets 

After initializing the ECB correctly, give it to IPX to perform 
your request. To listen for packets, call IPXListenFor- 
Packet(). This function takes the IPXTaskID and a pointer to 
an ECB. Receiving packets is straightforward. Put the number 
of the socket to be monitored in the socketNumber field of 
the ECB; a pointer to the ESR (event service routine) in the 
ESRAddress field; a pointer to an IPXHeader buffer and its 
length along with a buffer for data and its length in the 
fragmentDescriptor fields; and the number of fragments in 
the fragmentCount field. This process is shown in Figure 2. 

Sending packets is more complicated because you need to 
specify the address of the other workstation. Sending a packet 
requires the following information: 

• The internet address of the destination workstation. 

• The packet type (4 for IPX, 5 for SPX). 

• The socket number you are sending messages through. 

• The data to be sent. 

• The immediate address of a bridge that will route the 
packet. 

The immediate address is important because IPX needs to 
know how to start the message on its way. If no bridge is 
involved in sending the packet to the workstation, IPXGet- 
LocalTargetO returns the node address of the destination 
workstation. If a bridge is involved, then IPXGetLocal- 
Target() returns the address of the bridge; you should place 
this address in the immediateAddress field of the ECB. After 
filling the ECB, call IPXSendPacket() with the IPXTaskID and a 
pointer to the ECB. 

Event Service Routines 

Upon receiving a packet or sending a packet, IPX sets the 
inUseFlag of the associated ECB to zero, enters a completion 
code in the completionCode field, and invokes the ESR indi¬ 
cated by the ESRAddress field. On entry to the ESR, the fol¬ 
lowing conditions are valid: 
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Figure 1 Event control block structures 


typedef struct ECBFragment 
( 

void far ‘address; 

WORD size; /* low-high */ 
)ECBFragment; 


typedef struct ECB 

f 


void far ‘linkAddress; 
void (far *ESRAddress)(); 

BYTE inUseFlag; 

BYTE completionCode; 

WORD socketNumber; /* high-low 

BYTE IPXWorkspace[4]; /* N/A */ 

BYTE driverWorkspace[12]; /* N/A */ 

BYTE immediateAddress[6]; /* high-low 

WORD fragmentCount; /* low-high 

ECBFragment fragmentDescriptor[2]; 


ECB; 
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This is not the standard C calling sequence, of course, so 1 
generally code an assembly language front-end to a C lan¬ 
guage event service routine, using code like this: 


mov ax, DGROUP 

mov ds, ax 

push es 

push si 

call _ListenESR 

retf 

l set DS to the DGROUP of the VBX, push ES and SI to make a 
far pointer to an ECB on the stack, and then call the C lan¬ 
guage routine. In that routine, I am able to process the ECB 
further if I wish, but I need to signal my application that a 
network event has occurred. I call PostMessage() with a 
user-defined message, the ECB completion code, and a pointer 
to the ECB, as shown here: 

PostMessage(gIpxSpxHwnd, 

WM_LISTENESR, 

(WPARAM)ecbPtr->completionCode, 

(LPARAM)ecbPtr); 

Cleanup 

Before your application terminates, call IPXCancelEvent() 
on all outstanding ECBs, that is, those ECBs that have a non¬ 
zero inUseFlag. You should then call IPXCloseSocket() to 
close the socket, and before terminating, call IPXSPXDeinit() 
to allow IPX to release any resources allocated to your ap¬ 
plication. 

While IPX is a very flexible and powerful network protocol, 
setting up and using it can get you lost in a maze of ECBs, 
ESRs, and other TLAs (Three Letter Acronyms). VBXs (Visual 
Basic custom controls) are modules that can hide some of the 
complexity of Windows programming. My goal in writing the 
IPXSPX VBX was to hide most of the complexities of IPX 
programming and allow programmers to simply specify an ad¬ 
dress and data, letting the VBX send the data to the desired 
address. 

The IPXSPX Custom Control 

The IPXSPX VBX 1 designed contains the following Visual 
Basic properties: InSocket, OutSOcket, InECBs, OutECBs, Ad¬ 
dress, Code, Input, and Output. InSocket and OutSocket 
designate the sockets to open for sending and receiving data. 
InECBs and OutECBs specify how many ECB structures to allo¬ 
cate for use within the custom control. Address is the internet 
address of the destination workstation. Code is the completion 
code of an ECB when an event occurs. Input is the IPX header 
and data that the custom control has received, and Output is 
the data to send to the station identified by Address. 

The custom control also supports two events, Send and 
Receive. The VBX fires the Send event after it finishes sending 
data. IPX could potentially take a while to complete a send, 
and you may need to know when IPX has sent the packet. 
The VBX fires the Receive event after it receives a packet. In 
both cases, the Input property will contain the IPX header 
and data. 
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To build the custom control, you will need the source code 
from the code disk (see the table of contents for availability), 
plus the Control Development Kit from Microsoft for vbapi.h, 
vbapi.lib, and a modified libentry.obj. I generated an im¬ 
port library from nwipxspx.dll from the NetWare DOS Re¬ 
questor to provide access to the IPX functions that you will 
need. The assembly language ESR functions are provided in 
rhand.obj, along with source. I compiled the control with 
Microsoft Visual C++, but I have seen messages on Compu¬ 
Serve showing how a custom control can be built with Bor¬ 
land C++. 

The Good Stuff 

After all this talk of IPX/SPX and custom control program¬ 
ming, it is time for the good stuff, using Visual Basic to write a 
network-intrinsic application. I have written a small utility 
called NetChat to enable users to communicate on a NetWare 
network. NetChat consists of a main form that shows the at¬ 
tached servers and logged-in users on the network. Double¬ 
clicking on a user name shows that user’s connection number, 
login time, and internet address. Clicking the connect button 
will send a connection request to the user. If the other user 
responds, you will be able to type merrily away to each other 
until one of you decides to disconnect. 

Although I’ve talked about the destination address, I have 
never specified how to find it. In NetChat, I discover the ad¬ 
dress of another workstation by using some of the services 
provided in the dynamic link libraries shipped with the Net- 


Figure 2 Code to receive packets 


_fmemset(ecbPtr,0,sizeof(struct ECB)); 
_fmemset(ipxHeadPtr,0,sizeof(struct IPXHeader)); 

/* Set the socket, remember to swap it */ 
ecbPtr->socketNumber = IntSwap(InSocket); 

ecbPtr->ESRAddress = ListenESRHandler; 

/* Set two fragments, first is for the header, 

second is for the buffer to be filled with data */ 
ecbPtr->fragmentCount = 2; 

ecbPtr->fragmentDescriptor[0].address = ipxHeadPtr; 
ecbPtr->fragmentDescriptor[0].size = sizeof(IPXHeader); 
ecbPtr->fragmentDescriptor[l]-address = bufPtr; 
ecbPtr->fragmentDescriptor[l].size = MAX_PACKET_SIZE; 

/* Give it to IPX to receive any packets */ 
IPXListenForPacket(IPXTaskID, ecbPtr); 

/* End of File */ 


Ware DOS Requestor. One of those libraries, nwcolls.dll, con¬ 
tains many of the connection-oriented services that allow a 
programmer to find attached servers, scan the binderies of 
those servers, and many others. By the way, if you want to 
do some serious network programming and want to target 
NetWare, I suggest purchasing the NetWare Client SDK from 
Novell. It contains the libraries, header files, and documenta¬ 
tion required to access Netware’s many services. 
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Within NetChat, a function called ScanUsers() handles 
most of the work of discovering the other workstation’s ad¬ 
dress. This function obtains the local user's internet address 
and all the attached servers. It then queries those servers for 
their active connections and displays those names in the user- 
name list box. Knowing the connection number of a logged-in 
user permits a call to the NetWare server to return that user's 
internet address. Once the address of the other user is known, 
the communication can begin. The other user’s address is as¬ 
signed to the Address property and the connect request is 
placed in the Output property. NetChat uses a very simple 
protocol to connect, disconnect, and send data. NetChat also 
uses a simple finite-state machine to determine how to 
respond to user actions or incoming packets. 

Exercises for the Reader 

Developing an IPX/SPX custom control proved to be a lot of 
fun. Once the control was completed, I was able to make a 
network-intrinsic application with approximately 500 lines of 
Visual Basic code. You can obtain NetChat, the IPSPX custom 
control, and complete source code from a variety of sources 
listed in the table of contents. There are a still some issues to 
consider, however. When the control receives a packet, it pas¬ 
ses the IPX header and data to the application, making for 
some particularly ugly code. The source address of a packet is 


important to know, so a good exercise would be to create 
another property to hold the address so an application could 
get it directly. 

Since IPX does not provide connections or guaranteed 
delivery, if you want to make sure your packet was received, 
you have to do a lot of extra programming. Adding SPX sup¬ 
port would remove the need for much of the overhead as¬ 
sociated with guaranteed delivery and sequencing. SPX 
programming is very similar to IPX with its data structures and 
programming concepts. Name discovery is another area which 
could be reworked. IPX provides for the broadcasting of pack¬ 
ets. To broadcast to all stations, the packet's destination ad¬ 
dress should be filled with FFh. If you are broadcasting to the 
network that the workstation resides on, fill the immedi- 
ateAddress field with FFh. Broadcasting allows you to discover 
the address of another workstation by sending packets to all 
workstations listening on a specific socket. When the other 
workstation sends back a packet, you can retrieve its address 
from the packet's source address. 

And that's just the beginning. Once packets are moving 
from node to node, just about anything can happen. At the 
application level, you can define any protocol you wish and 
start distributing the work across the system - and that is 
what networks are all about. □ 





Do you need WYSIWYG Text Processing 
for your WINDOWS Application? 


Just get the TX Text-Control and the 1C Image-Control DLLs 
and change your DOS applications to high quality 
WINDOWS software with such features as 


- Multiple fonts 

- Paragraph formatting 

- Integration of images 

- Zooming 

- Macrofields, Visual Basic interface,. 


GET YOUR FREE DEMO TODAY! 

Call 203-561-9805 (USA or Canada) 

The Aristos Company, 957 Farmington Avenue 
West Hartford, CT 06107, Phone 203-561 -9805 
Fax 203-561 -9807, CompuServe 73020,2101 




Elsewhere contact 

DBS GmbH, Fahrenheitstrasse 1,28359 Bremen 

Germany, Phone+49421 / 2208-161 

Fax +49421 / 2208-273, CompuServe 100013,115 

Or download TXDEMO.ZIP from CompuServe 
(Forum WINSDK, section PUBLIC UTILITIES) 


DBS 
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LITTLE EIG LAN 



Peer to Peer LAN, to 250 nodes^ 
$75 total software cost! 

No matter how many nodes! 

Use ARCnet, serial or parallel Z 78 ' 

to link your computers, Ethernet soon. AT, 

Mixed mode routing 

Any combination of above connection is possible 
on any given node. 

Use with windows . 


Try the 1st truly low cost LAN 

• Connect 2 or 3 PC*. XTi, ATs, PS/2* 

• the* serial port* and 5 write ccfcte 

• Run* at U5K baud, up to 90 feet 
.transfer 5500 bytes per second (Ms) 

• Runs m background, total* trarspaent 

• Share any device, aiy flle. any Pme 

• Needs only 15K ot ram 

• Just S26 per network. NOT PER NOOB 

• Replace all We transfer software 
. Version 23P now has TlnyMAB. 

•CMS? 20XE0 SCUD WORLDWIDE 

Skeptical? We make befievm! 


Information Modes 

P.O. Drawer F 
Denton TX 76202 
817-387-3339 Techline 

1-800-628-7992 Orders 
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Controlling WinHelp’s 
Always-on-Top State 




Ron Burk 

When you select a window and give it the input focus, Windows brings it to the 
top of the Z-order, covering whatever portions of other windows lie behind. That 
makes sense most of the time, but sometimes you want a window that is not 
obscured by the current window, a kind of "always-on-top” window. Under Windows 
3.0, programmers had to cobble together this kind of window with crude techniques 
such as checking the Z-order with a timer every second or so and bringing the 
desired window to the top if necessary. Windows 3.1, however, added an always-on- 
top style bit to windows, and the use of this bit has proliferated; the feature is 
handy for toolbar windows that cannot be obscured while you work. 

Another useful application of an always-on-top window is for online help. If you 
are running your application maximized and you call up online help (assuming your 
application uses standard WinHelp help files), the help window appears on top of 
your application. When you select the application window again, it covers the help 
window. Wouldn’t it be nice if you could still refer to the help window while you 
work within your maximized application window? 

Fortunately, the Windows 3.1 winhelp.exe gives you this capability, although 
many users don’t realize it. If you select the “Help” menu from a WinHelp help 
window, you will see a menu item called “Always on Top”. Selecting that menu item 
gives it a checkmark and makes the window an always-on-top window. It also gives 
the window a shadow, to provide visual indication that it is in the always-on-top 
state. 

WinHelp is almost compliant with Microsoft's guidelines for this feature, but not 
quite. Microsoft’s Application Design Guide recommends that you place the “Always 
on Top” menu item in the system menu for the window, which does seem like a 
more logical place than in the “Help” menu. Microsoft also recommends that you use 
a gray shadow, but WinHelp’s shadow looks black and very thin on my screen. 1 
much prefer the look offered by Steven Palmer’s code (“Visual Implementation: 
Shadowed Popup Windows,” Windows/DOS Developer’s Journal, July 1993) for 
shadowed windows. 

Sometimes you might want to control the help window's always-on-top state 
programmatically. Unfortunately, that requires a little trickery. This article shows you 
how to control the help window’s always-on-top state, either from your application 
code or from help macros compiled into the .hip file. 

Help Macros 

When you build a help file with the Windows 3.1 compiler, you can embed 
references to built-in WinHelp macros (they are actually functions, but I will follow 
Microsoft’s inexplicable naming convention). You can tie these macros to hotspots in 
the text, buttons in the button bar, or menu items in the help window’s menu. 
Almost every action in the help window’s menu has a corresponding WinHelp 
macro. For example, just as there is a WinHelp menu item to print the current topic, 
there is also a WinHelp macro called Print () that prints the current topic. A macro 
called HelpOnTopO produces the same effect as the “Always on Top” menu item. 


Flon Burk is the editor of Windows/DOS Developer’s Journal and has been a program¬ 
mer for 12 years. He is working on a book tentatively titled WinHelp for Programmers 
and Technical Writers. You may contact him at Burk Labs, P.O. Box 3082, Redmond, 
WA 98073-3082. CIS: 70302,2566. BIX: rlburk; Internet: ronb@rdpub.com (". . . 
luunetlrdpublronb") 
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Figure 1 Determining window's aiways-on-top state 


int CALLBACK _export IsOnTop(LONG Param) 

{ 

HWND Window ■ (HWND)LOWORD(Param); 
return (GetWindowLong(Window, GWL EXSTYLE) 
& WS_EX_T0PM0ST) != 0; 

) 

/* End of File */ 


Unfortunately, that mechanical translation of menu 
functionality to macro functionality falls down for the HelpOn- 
Top() macro. Just like the corresponding menu item, HelpOn- 
Top() toggles the window’s always-on-top state — but with 
no way to determine the current state, you don’t know what 
HelpOnTopO will do! WinHelp does not give you any other 
macros to determine the help window’s always-on-top state, 
so the only solution is to write a bit of custom code. 

Extending WinHelp 

In adding functionality connected to the Windows help sys¬ 
tem, you should always consider using a DLL function. The 
reason is that WinHelp macros can call DLL functions, and your 
application can invoke WinHelp macros via the UinHelpO API 
function. So, if you can implement functionality as a WinHelp- 
callable DLL function, it will be available to both your applica¬ 
tion and to WinHelp macros. 

In this case, all that’s needed is a way to determine the 
help window’s always-on-top state. You can glean that infor¬ 
mation from the corresponding window style bit, as shown in 
the function IsOnTopO in Figure 1. Once you put the function 


in Figure 1 into a DLL, all you need to do is declare it in the 
[Config] section of your help project file to make it available 
as a help macro ("RR” is a legal abbreviation for “Register- 
Routine”): 

[Config] 

RR("mydl1.dll","IsOnTop","i=U") 

WinHelp does not support general-purpose variables for Win¬ 
Help macros, but it does supply a few built-in variables that 
you can use as parameters to WinHelp macros. In particular, 
hwndApp is a predefined variable that contains the handle to 
the main help window, while hwndContext contains the hand¬ 
le to the help window that currently has the input focus (this 
could be the main help window or a secondary help window). 
Since HelpOnTopO also affects secondary windows, you could 
pass either variable. Oddly enough, these are 32-bit variables, 
and the window handle is in the lower half, so IsOnTopO first 
extracts the window handle from its parameter before using it 
to obtain the style bit. 

Once you create the DLL and register the DLL function, you 
can use it in your help file. For example, to create a help 
window button labeled “Force Top” that forces the help win¬ 
dow into the always-on-top state, you could use the Create- 
Button() macro in your help project file, as shown in Figure 2. 

Application Control 

You might view online help as a passive adjunct to your 
application, but more and more applications are making it an 
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COMM-DRV™ 

COMM-DRV is a professional serial communication library for Windows and MS-DOS. In addition to the libraries, it 
comes with an extensive set of utilities, including a true Windows replacement driver, a true MS-DOS device driver, 
several TSRs. DLLs, debugging monitor, and much more. COMM-DRV may be used with any Language, any Tool, any 
Database Language/Environment, and any Application. Do not be fooled by false claims. COMM-DRV will be the only- 
serial communication development tool you need. When you purchase COMM-DRV, you inherit a team of experienced 
professional software engineers to help in your design. And you get a 30 day money back guarantee. 

"Serial communication is at the core of what we do, and COMM-DRV has helped us rapidly develop new applications, and easily add 
multiple port features. We've been very impressed with the flexibility of COMM-DRV, and the technical support has been outstanding." 

Lee Perryman, Deputy Director and head of technology development, Associated Press Broadcast Services, Washington, DC 

• Transparent support for several smart cards(Amet Smartplus series. 
Digiboard COMXi, PCXi, PCXm, PCXe). 

• Support for all dumb mulitport boards on the market. 

• Asynchronous callback to user functions on different serial communica¬ 
tion events(modem signals, buffer count, character reception and much 
more). 

• Timed asynchronous callbacks to user functions. 

• X, Y, & Zmodem on multiple ports concurrently. 

• Complete source code to all libraries. 

• Llnlimited number of ports active concurrently. 

• Real time serial port monitoring to screen and disk. 

• Quickbasic, Visual Basic, C, Visual C++, Assembly, Microsoft Access 
examples. 

• Hardware/Software Flow Control. 

• Interrupt 14H/FOSSIL/EBIOS replacement. 

• One API to leam (Same for Windows & MS-DOS). 

• 100% Port re-entrant codeflmportant for multitasking). 

• Desqview®, Procomm® Windows, PCBoard® BBS PcAnywhere® com¬ 
patible. 

• Integrate with any database tool, language, or application without writing 
any serial communication code. 

• ANSI/BIOS screen management utility. jj 

• TSR to redirect serial data to keyboard buffer, transparent to user 
application(Great for barcode & POS apps). 

• High level Hayes compatible modem support. 

• True Windows comm device replacement. Use your favorite Windows 
communication applications on all multiport cards we support. 

• True DOS device driver that allows serial ports to be opened as normal 

files under MS-DOS or Windows. ! 

• Transmit data from user callback on any eventflmportant for multidrop 
applications). 

• 8250/16450/16550 Auto detection/Up to 115200 baud. 

• Remap baud rates/Change baud rate divisor. 

• Product customization. 

COMM-LOG™ 

Group of cooperating programs and TSRs for developing 
serial applications quickly and efficiently. Programs and 
TSRs may be called directly from applications by shelling 
to them or by using a "C" API. Alternatively, applications 
may be built entirely with English like scripts. 

COMM-LOG Features: 

• TSR that log serial data to disk entirely in the background concurrently 
on any number of ports. Data may be extracted from the file while 
logging is in progress. 

• TSR to perform X/Y/Zmodem file transfers entirely in the background 
concurrently on any number of ports. 

• Full featured script engine that can function standalone or that may be 
called from a user application. Scripts may be run in the background. 

• Extensive set of examples. 

MTASK™ 

Multitasking kernel used in the development of multi¬ 
threaded applications and TSRs that run in the background. 

Its used commercially to create background TSRs for fax, 

communication, data acquisition, and many other applica¬ 
tions. All tasks may call DOS functions. 

MTASK Features: 

• Create and destroy tasks dynamically. 

• Put tasks to sleep for specific duration. 

• Send/receive messages between seperate threads in application and/or 
between TSRs running in the background. 

• Re-entrant libraries that include functions that make creating TSRs as 
easy as a C or Assembly function call. 

• Extensive set of example that show the ease of writing TSR that run 
entirely in the background. 

COMM-DRV.$189.95 

COMM-LOG..SI 89.95 

MTASK.S299.95 

COMM-DRV, MTASK Combo.S399.95 

COMM-DRV, MTASK, COMM-LOG Combo ... S499.95 

Company: WCSC 

Address: 2470 S. Dairy Ashford Suite 188, 

Houston, TX, 77099 

Telephones: 1 - 800 - 966-4832 

713-498-4832 

Fax 713-568-3334 

BBS 713-568-6401 

Visa/Mastercard/American Express/Optima 
P.O./Checks/Wire transfers 

4 Port Multiport Card(16450).$110.00 

4 Port Multiport Card(16550A).$170.00 

8 Port Multiport Card(16550A).S225.00 
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Figure 2 Sample declarations for ISOnTopQ 


[Config] 

RegisterRoutine("ontop.dll", "IsOnTop", "i*U") 

CB("ForceTop M ,"Topmost","IfThen(Not(IsOnTop(hwndApp)),'HelpOnTop() 1 )") 

active participant to help users through complex interactions. 
Examples of this include Microsoft’s “Wizards” and “Cue Cards.” 
You can create some cheap and dirty effects like this by using 
the macros just described from your application. 

For example, suppose you have implemented context-sen¬ 
sitive help throughout your application. If the user hits the FI 
key in the midst of a procedure-oriented task (filling out a 
dialog box, perhaps), your application could not only call up a 
help window that enumerates the steps the user should take, 
but also set the help window's always-on-top state until the 
user completes the task, so that the steps will remain visible 
to help the user through to completion. 

Your application could just locate the help window’s hand¬ 
le and call SetWindowPos () to make it a topmost window. In 
fact, that is pretty easy to do, because it turns out that win- 
help, exe creates exactly one main help window to service 
however many applications are currently using the WinHelpO 
API function. Since that window has a unique class name 
(“MS_WINHELP"), it is fairly safe to locate it and modify it like 
this: 

HWND Help=Fi ndWindow("MS_WINHELP", NULL); 

SetWindowPos(Help, HWND_T0PM0ST,0,0, 0,0,SWP_SH0WWIND0W); 


C a™ C++ DOCUMENTATION 


C-METRIC™ 


($59) COMPLEXITY / QUALITY 

lomatic path complexity for functions and 


■ Calculates “cyclomatic" path complexity 1 

• Counts lines with comments, code, and 'C' statements 


system 


filel 

main 

file2 

—sub2 

file2 

1—sub3 

file2 

1—sub4 

filel 

— main (recursv) 


--- Ibryl, Ibry2 


(-(, ALL™($69) FUNCTION HIERARCHY 


> Tree-Diagram showing function hierarchy 

■ Table-Of-Contents of functions versus files 

■ Summary and detailed cross-reference of functions 


C'-CMT ($69) FUNCTION COMMENT 

• Generates and inserts function comment blocks 

• Can be re-run to update the comment blocks 

• Retains any user-generated comments 


while (i<j) 

if(i<k) { 
| i=k; 


r ff-************* 

sub2 USERS: main 

CALLS: sub3 sub4 
PARAM: argl arg2 
LOCAL: varl 
GLOBL: var2 var3 

ZL 


C-US T t TS69) LISTS OR REFORMATS 


■ Action-Diagrams show logic/control flow 

> Optional line numbers, page numbers, and titles 

> Reformats source to various standardized formats 


( -REI™($59) CROSS-REFERENCES IDENTIFIERS 


■ Local/parameter/global/define summary or cross-reference 

■ Produces class-hierarchy tree-diagram for C++ classes 


SPECIAL: ($199) C-DOC^ DOS Package ($325 Value) 


_ |fi£ _ 

All 5 programs fully integrated as 1 overall C-DOC program 

• Processes multiple directories/files up to 15,000 total lines 

• Unconditional 30-day money-back guarantee of satisfaction 

NEW: C-DOC™Professional ($299); DOS, OS/2. Windows 

• Processes 150,000 lines, 3-ring binder/case, 2-pass deferred reports 


!! NEW 5.0!! Point-and-click G.U.I. operation!! 


SOFTWARE BLACKSMITHS INC 

6064 St Ives Way, Mississauga 
ONT Canada L5N-4M1 


Voice/Fax: (4161-858-4466 
Demo/BBS: (416)-858-1916 
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This is not a good approach, however, because winhelp.exe 
does at least two other things when you first select its “Al¬ 
ways on Top” menu item. First, it adds a checkmark to the 
menu item, to help indicate its state to the user. Second, it 
draws a shadow around the help window for further visual 
feedback. If you just call SetWindowPos () yourself, neither of 
these things will happen, so the result will not be visually 
consistent for the user. Instead, just use the WinHelpO API 
function to execute the HelpOnTopf) macro yourself: 

WinHelp(Window,"C:Wmyhelp.hip", HELP_C0MMAND, 

(DWORD)(LPSTR)"Help0nTop()"); 

You can execute arbitrary macro strings with the HELP_C0M- 
MAND variation of WinHelpO, so you could just pass in the 
entire IfThen () macro shown in Figure 2. The code disk (see 
the table of contents for availability) contains an example DLL 
and help file to demonstrate the code shown here. 

Summary 

As software prices go down and free technical support be¬ 
comes a bigger expense for vendors, good online help be¬ 
comes more critical. WinHelp has its limitations, but by ex¬ 
tending it with DLL functions, you can create feature-filled on¬ 
line help that outshines the competition and helps lower your 
technical support costs. □ 
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for 3MF, TIFF, FCX, GIF, TGA, and JFEG Images 
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Load and save 

BMP/TIFF/PCX/GIF/TGA/JPEG 

Powerful grayscale and color 
image processing: brightness, 
contrast, sharpen, outline, 
equalize, matrix convolution, 
rotate, resize, and more 

Color reduction for fast and 
accurate display of 24-bit images 

Support for EGAA/GA/SVGA, 32K- Your Windows application can load and 
and 16 million-color displays save bmp. vff. fcx, gif, tga, and jpeg 



Scan b/w, grayscale, and color 
images with ScanJet scanners 


Hies, control scanner and printer, and have 
powerful Image processing and color 
reduction for the very best Image display. 


Print halftones, diffusion scatters, 
and color pictures 

Convert images between 1-, 8-, 
and 24-bit formats 

Convert color to grayscale 

Includes a complete image 
processing application with C 
source 


Victor Image Processing Library 
for Windows (DLL), $295 

Victor Image Processing Library 
for DOS, supports Microsoft 
and Borland C/C++ compilers, $195 

Call or fax to order 
314 - 962-7833 


CCatenary Systems 


470 Bellevieui St Louis MO 63119 


voice/fax 314-962-7833 


Victor Image Processing Library for Windows or for DOS. No royalties. Source code available, visa/mc/cod. 
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A High-Resolution Windows 
C++ Timer Class 

Mark Szamrej 

High-resolution timing on the PC has historically been a problem because multi¬ 
ple applications can end up competing for the rather overused PC timer, which the 
BIOS also wants to use as a system clock. Windows offers a set of timer services 
via the functions SetTimer() and KillTimer(), but these timers are far from high 
resolution. In fact, since Windows only delivers these timer events after your ap¬ 
plication has retrieved all other messages in its input queue, the Windows timers 
are useless for time-critical applications. 

Microsoft's multimedia extensions offered a more realistic solution to high- 
resolution timing- (one-millisecond resolution on an 80386 or better), and these 
extensions were incorporated into Windows 3.1 in the form of mmsystem.dll. Al¬ 
though you no longer have to roll your own timer solutions for Windows 
applications, the multimedia services are not necessarily the most con¬ 
venient API for specific timer applications. In this article, I present a high- 
resolution C++ timer class that uses the Windows multimedia extensions to 
provide high resolution and accuracy. 

Background 

PC timing starts with a 1193180.0Hz oscillator and an 8253 programmable 
counter chip. The 8253 counter chip is preset to some 16-bit value (normally 
OxFFFF) and it counts down at the rate determined by the oscillator, when 
the count reaches zero it generates an interrupt (INT 0x08 ) and the process 
starts over again. Assuming the 8253 counter is being set to OxFFFF, then 
you can divide the oscillator frequency by the initial count value for 

1193180 / 65535 = 18.2 

interrupts per second or one interrupt approximately every 55 milliseconds. That is 
the well-known frequency that the BIOS uses to maintain the system clock. 


Mark Szamrej spent six years as a senior engineer developing high-speed systems 
for testing Air Force fighter aircraft He currently works for Fujitsu Networks In¬ 
dustry where he develops LAN-based software and performs "key algorithm" work. 
He can be reached at (315) 891-3340. 
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SLATE ^LATEL SCRIPT 

with w ^ & 

Graphics SPRINT 

Would Text and Graphic 
Printer support for over 850 
printers give you an edge? 

By including SLATE with Graphics, you 
can print Text and Graphics on over 850 
printers. Immediately! Painlessly! 

You can use SLATE in your product 
with no royalties. It gets you out of the 
printer support business. 

Make your product more functional 
and competitive by using SLATE'S 
advanced text features: 

• Output to parallel printers, serial printers, DOS 

files and Novell network printers. 

• Support proportional fonts and scalable fonts. 

• Set exact print positions. 

• Kerning, leading, underlining, and strike through. 

• Automatic character set conversion. 

• Print lines and shaded areas (laser printers only). 

SLATE with Graphics adds advanced 
graphic printing features: 

• Print images from the screen, PCX or TIFF files, 

or custom image systems. 

• Print lines and shaded areas on all printers. 

• Scale and Rotate printed image. 

• Print grey scale and color images. 

• Intermix text and graphics. 

SLATE is a C or Basic library of over 
170 text printing functions, a Database 
of over 850 printers, and End User 
configuration and testing programs. 
SLATE with Graphics adds over 60 
graphic printing functions. 

Would a User Configurable 
Report Writer give you a 
more competitive product? 

SCRIPT is a full featured Text 
Formatting library that can be 
incorporated into your application. 
SCRIPT uses SLATE as its printer 
driver. SCRIPT lets you merge text, 
data, and S_PRINT formatting 
commands from ASCII files and your 
application. 

Enhance your product by taking 
advantage of SCRIPT'S features: 

• Allow users to alter document format. 

• Set exact positions, center, right adjust, and 

decimal align. 

• Fill paragraphs from unformatted text. 

• Add lines, shaded areas, logos, signatures, etc. 

• Add commands and macros. 

Call or FAX now for a complete catalog 
and developer's guide for The 
Symmetry Group's printer support 
products. Order SLATE for $299, 

SLATE with Graphics for S448, or 
SCRIPT for SI99 with our risk free, 30 
day return policy. 


The 

Symmetry 
Group 


800-346-3938 

PO Box 26195 
Columbus, OH 43226, USA 
614-431-2667* FAX 614-431-5734 
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18.5 interrupts per second is a fairly 
low-resolution timer. However, the BIOS 
installs an interrupt handler for INT 
0x08 that expects to be called 18.5 
times per second in order to maintain 
the system clock. To obtain higher- 
resolution timing, DOS applications 
sometimes reprogram the counter for a 
higher interrupt rate, and then manual¬ 
ly call the original BIOS interrupt handler 


at the slower rate. For example, you 
could program the chip to generate in¬ 
terrupts four times as frequently and 
call the original handler on every fourth 
interrupt, which would give you higher 
resolution without interfering with the 
system clock. 

Unlike DOS, Windows has a 
general framework for sharing PC 
hardware components among 


Figure 1 CTimerAPI 

Constructors 

CTimerO 

Constructs a CTimer object 

~CTimer() 

Destructor 

Stopwatch Functions 

void Start() 

Starts interval timer 

void Stop() 

Stops interval timer 

DWORD Read() 

Returns elapsed time in milliseconds 

void CondnueO 

Resumes the timer 

void ResetO 

Reinitializes the timer to default settings 

BOOL IsR unningO 

Returns TRUE if the timer is running 

DWORD StartTimeO 

Time at which timer was started 

DWORD StopTimeQ 

Time at which timer was stopped 

Event Functions 

BOOL InEventO 

TRUE if currently in an event 

BOOL CancelEventy 

TRUE if the current event was canceled 

BOOL EventOneShot(UlNT Delay, HWND Window, UINT Message, DWORD User) 

Post the message (and user data) to the desired window after the Delay time 
expires. wParam contains the number of missed events. 

BOOL EventOneShot(UINT Delay, FARPROC Callback, DWORD User) 

Call the callback function (passing user data) after the Delay time expires. 

BOOL EventPeriodicfUINT Period, HWND Window, UINT Message, DWORD User) 

Post message every Period milliseconds. wParam contains the number of 
missed events. 

BOOL EventPeriodic(UINT Period, FARPROC Callback, DWORD User) 

Call Callback function every Period milliseconds. 

Note: The callback functions must be declared as: 
void FAR PASCAL IpfnCallbackfDWORD dwUser); 

Use the_export keyword, MakeProcinstanceO, or some other method to get DS 

set correctly on entry to your function. 
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multiple applications: virtual device 
drivers (VxDS). Specifically, Windows 
uses a Virtual Timer Device (VTD) to vir¬ 
tualize the timer for Windows and DOS 
applications. The VTD can reprogram 
the 8253 initial count value to generate 
interrupts at a faster rate. Unlike Win¬ 


dows 3.0, which trapped and virtualized 
I/O requests to the timer port, Windows 
3.1 defaults to allowing direct access to 
the timer port. The VTD API is docu¬ 
mented in the device driver develop¬ 
ment kit (DDK), so there is no need ever 
to access the hardware directly. 



Develop Pen Appucations with 

PqvRight! Pro. 


Perfe<t for designing forms 

Design custom forms with the look and 
feel of the forms your customers are 
using today. With PenRight! Pro you 
can incorporate your customers' cur¬ 
rent graphics into attractive new pen¬ 
centric applications. 

Optimized for mobile 
applications 

PenRight! Pro will enables you to 
incorporate all the latest communica¬ 
tions features including wireless, into 
your applications to make them truly 
mobile. Plus, your applications can 
take advantage of the huge selection of 
form factors, processors, battery tech¬ 
nologies, memory options, and weight 
choices to meet your customer's needs. 

Proven in vertical markets 

Applications developed with PenRight! 
Pro are in use meeting customer needs 
in such industries as pharmaceutical, 
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The low-level VTD functions are used by both the ToolHelp 
and multimedia timing functions. Calling these functions (or 
the VTD directly) incurs a slight amount of overhead. The over¬ 
head is a constant and is required to execute the VTD code, 
which runs in ring 0 (the most privileged level of 80x86 
protected mode). 

Desired Timer Services 

In designing the timer class I first considered what it is that 
a timer should do. I came up with several uses, but they all 
fundamentally fail into one of two categories: a timer should 
either measure time or generate an event after a specified 
amount of time has elapsed. 

The CTimer class fulfills both requirements. A CTimer object 
can function as a “stopwatch” to measure time intervals from 
a single millisecond to about 49 days. A CTimer can also 


generate an event after a certain amount of time has elapsed. 
Events can be in the form of a posted message or a call to a 
callback function. Events can occur once (one-shot) or at 
regular intervals (periodic). 

The events provided by the multimedia timer services are 
essentially interrupts. Unfortunately, Windows is not reentrant 
and it is not generally safe to call any Windows API function 
other than PostMessage() while handling an interrupt. That 
restriction can be important in designing your application. You 
also have to keep in mind that the faster you set the timer, 
the less you can expect to accomplish on each timer event. 
For example, if you create a CTimer object that posts a 
WM_USER message every millisecond, and you attempt to per¬ 
form complex computations for each WM_USER message, the 
message queue will probably overflow because the timer 
events will fire faster than you can process them. 


Higher Resolutions 


Some people are harder to please than others. If you 
need more resolution than a single millisecond, you can 
communicate directly with the VTD (Virtual Timer Device) 
to read the system time with a resolution of under a 
microsecond (1,000 microseconds = 1 millisecond). 

As mentioned in the article, a 1.193MHz oscillator is the 
source of timing information, and it gets divided by an 
8253 chip down to lower resolutions. Since the oscillator 
emits 1,193,000 pulses per second, it offers a maximium 
resolution of 1/1,193,000, or about 0.838 microseconds. 
This is too fast to allow an interrupt handler to do any¬ 
thing useful, but you can read the current clock count at 
this resolution to make more accurate timings. 

The first is to get the address of the entry point to the 
VTD. You do this by setting AX to 0x1684, and BX to 5, 
then issuing an INT 2Fh. When this interrupt returns, 
ES:DI will hold the entry point of the VTD. The entry point 
is actually a selector to a call gate and not a real address. 
You can then read the current system time by setting the 
AX register to 0x0100 and calling the VTD entry point. The 
return value is a 64-bit word in EDX:EAX that represents 
the system time to a resolution of .838 microseconds. 

The VTD is a VxD, so using 32-bit registers (EDX and EAX) 
is natural for it. Windows applications, on the other hand, 
have a bit of a problem with 32-bit registers. Rather then 
use a 32-bit assembler, I used a tip from Paul Bonneau’s 
column (Windows/DOS Developer's Journal, April 1993) on 
generating 32-bit code with the Microsoft C compiler. The 
result looks like this: 

// Note: This function requires: 

// Windows 3.1 running in enhanced mode. 

// Windows 3.0 and 286's need not apply. 

void GetSuperTime(){ 

FARPR0C IpfnVTD; // Address of the VTD 

DWORD dwUpper; // Upper and lower halves 

DWORD dwLower; // of the 64 bit time 


/* Start of Assembler block */ 

_asm{ 

mov ax, 1684h ; Set up regs to get 

mov bx, 5 ; entry point to VTD 

int 2fh; ; Make the call 

mov WORD PTR 1 pfnVTD[2], es ; ES:DI has the 

mov WORD PTR 1pfnVTD[0], di ; address we want 

; The address of the VTD is stored in IpfnVTD. 

; We can now call it directly. 

mov ax, OlOOh ; VTD_Get_Real_Time function 
call IpfnVTD ; Get the time 


_emit 0x66 

mov WORD PTR dwUpper, dx 
_emit 0x66 

mov WORD PTR dwLower, ax 


The '_emit 0x66' 
instruction 
converts these 
opcodes into: 
mov DWORD PTR, EDX 
mov DWORD PTR, EAX 


} /* End of Assembler block */ 

} /* End of function */ 

DOS applications which are run in a “DOS Box" can also 
use this code. The DWORDs and the FARPROCs will have to 
be replaced with comparable data types, but the VTD will 
still be accessible. Windows and DOS applications will 
report different addresses, but they will both read the 
same time. 

Although this function doesn’t do much, dwUpper:dw¬ 
Lower is a 64-bit value with a very accurate system time. 
By the way, don’t worry about checking the clock for 
rollover. It will take 500,000 years for it to happen. □ 
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Anatomy of a CTimer 

A CTimer is a single object with two distinct parts. One half 
of the CTimer functions as a typical stopwatch, allowing you 
to start, stop, read elapsed time, reset, pause, and resume. 
This part is relatively straightforward in both operation and 
implementation. All member functions are inlined in the .h 
file. 

The other half of a CTimer is the event section. This section 
is responsible for creating one-shot and periodic events that 
notify you after a certain time interval has elapsed. The event 
section relies on the multimedia time functions that call a 
callback function at interrupt time. This creates something of a 
problem, since all code and data referenced by the callback 
function must be in fixed, nondiscardable segments, while C- 
Timer objects created by an application will likely be in move- 
able, swappable memory. 


Listing 1 ctimer.c — Main source for CTimer class 


#ifndef STRICT 

Idefine STRICT /* Ensure STRICT is defined */ 

#endif 

linclude <windows.h> 
linclude <mmsystem.h> 
linclude "timerdll.h" 
linclude "ctimer.h" 

Idefine DESIRED_RES0LUTI0N 1 

/* Initialize static member variables */ 

UINT CTimer::pm_manyTimers=0; 

UINT CTimer::pm_nextTimerID=0; 

/* Initialize the CTimer class */ 
static CTimer thePhantomTimer; 

^********* Constructor *********/ 

CTimer::CTimer(){ 

TIMECAPS timeCaps; 

m_bRunning=FALSE; 
m_dwStartTime=0L; 
m_dwStopTime=0L; 
m_dwEventID=OL; 

m_IdCTimer = ++pm_nextTimerID; 
if(!pm_manyTimers++){ 

timeGetDevCaps(&timeCaps, sizeof(TIMECAPS)); 
m_minRes=max(DESIRED_RESOLUTION, timeCaps.wPeriodMin); 
SetMinDllPeriod(m_minRes); 
timeBeginPeriod(m_minRes); 

} 

} 

y********* Destructor *********/ 

CTimer::~CTimer()( 

Cancel EventQ; 
if(! --pmjnanyTimers) 

timeEndPeriod(m_minRes); 

I 

BOOL _inline CTimer::CancelEvent{){ 
return EventCIear(m_dwEventID); 

) 

BOOL CTimer::InEvent(){ 

if(EventGetIndex(m_dwEventID) != -1) 
return TRUE; 

el se 

return FALSE; 
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The solution I used was to place the event handler (inter¬ 
rupt code) in a DLL with fixed and nondiscardable segment 
attributes. A CTimer object uses an internal DLL interface to 
provide it with event-handling capabilities. The DLL stores all 
the information it needs to generate the event, so it does not 
have to refer to the CTimer object (which might be swapped 
out) at interrupt time. 

Using a CTimer 

Figure 1 shows the API for the CTimer. You can create any 
number of CTimer objects, and each CTimer can measure 
time intervals and create events. The CTimer will cancel an 
existing event if you tell it to create a new event. The CTimer 
will cancel any outstanding events when its destructor is 
called. 


Listing 1 ctimer.c — Main source for CTimer class 


/* Create a one-shot 'Callback' event */ 
BOOL CTimer::EventOneShot(UINT wDelay, 
FARPROC lpfnCallback, 

DWORD dwUser) 

( 

CancelEvent(); 

m_dwEventID = NewEvent(m_IdCTimer, 
EVTBIT_0NESH0T | EVTBIT_CALLBACK, 
wDelay, 

(DWORD)lpfnCallback, 
dwUser); 

return (BOOL) m_dwEventID; 

) 

/* Create a one-shot 'Message' event */ 
BOOL CTimer::EventOneShot(UINT wDelay, 

HWND hParent, UINT idMsg, 
DWORD dwUser) 

( 

Cancel Event(); 

m_dwEventID = NewEvent(m_IdCTimer, 
EVTBIT_0NESH0T | EVTBIT_MESSAGE, 
wDelay, MAKELONG(hParent,idMsg), 
dwUser); 

return (BOOL) m dwEventID; 

} 

/* Create a periodic 'Callback' event */ 
BOOL CTimer::EventPeriodic(UINT wDelay, 
FARPROC lpfnCallback, 

DWORD dwUser) 

( 

CancelEvent(); 

m_dwEventID = NewEvent(m_IdCTimer, 

EVTBIT_PERIODIC | EVTBIT_CALLBACK, 
wDelay, (DWORD)lpfnCallback, 
dwUser); 

return (BOOL) m_dwEventID; 

) 

/* Create a periodic 'Message' event */ 
BOOL CTimer::EventPeriodic(UINT wDelay, 
HWND hParent, UINT idMsg, 
DWORD dwUser) 

{ 

CancelEvent(); 

m_dwEventID = NewEvent(m_IdCTimer, 
EVTBIT_PERIODIC | EVTBIT_MESSAGE, 
wDelay, MAKELONG(hParent,idMsg), 
dwUser); 

return (BOOL) m_dwEventID; 

) 

/* End of File */ 


Windows supports scheduling a maximum of eight events. 
The DLL is aware of this limit and restricts itself to eight 
events. Attempts to create additional events will fail until an 
existing event is terminated. There is no limit to the number 
of simultaneous time intervals you can measure. 

A CTimer can perform a one-shot or periodic event. Over¬ 
loaded member functions allow events which return a mes¬ 
sage or perform a callback function. When an event occurs, 
the TimerFunc() function in the DLL is called. Information on 
the event is stored in an EventTable structure which deter¬ 
mines whether to call a callback function or post a message 
to a window. If you pass the address of a callback function, 
remember that all code and data referenced by your callback 
function must reside in fixed, nondiscardable segments. The 
callback function will be called at interrupt time, so the only 
API function you can call is PostMessage(). 

If your application's message queue is full, then Post- 
Message () will fail. For periodic events, the DLL increments the 
wMissed variable in this case. When the message is eventually 
posted, the wParam parameter of the message will contain the 
count of how many attempts to post a message have failed. 
Unlike periodic events, one-shot events won’t have another 
chance to post the message. If PostMessagef) fails, the DLL 
has to create another one-shot event and then try to post the 
message later. When the message is finally posted, the w- 
Param will contain the number of failed PostMessage() at¬ 
tempts. Remember that although the messages are posted at 
interrupt time, your application will not receive them until 
later. 


Listing 2 ctimer.h - CTimer declaration 


lifndef _CTIMER_FILE_ 

Idefine _CTIMER_FILE_ 

class CTimer 

{ 

private: 

static UINT pm_manyTimers; 
static UINT pm_nextTimerID; 

UINT m_IdCTimer; 

DWORD m_dwEventID; 

protected: 

BOOL m_bRunning; 

DWORD m_dwStartTime; 

DWORD m_dwStopTime; 

UINT mjninRes; 

public: 

CTimer(); 

~CTimer(); 

/****** Event functions ******/ 

BOOL InEvent(); 

BOOL inline CancelEventQ; 

BOOL EventOneShot(UINT, FARPROC, DWORD =0L); 

BOOL EventOneShot(UINT, HWND, UINT, DWORD =0L); 

BOOL EventPeriodic(UINT, FARPROC, DWORD =0L); 

BOOL EventPeriodic(UINT, HWND, UINT, DWORD =0L); 

/* Timing (stopwatch) functions */ 

BOOL IsRunning(){return m_bRunning;}; 

DWORD StartTime(){return m_dwStartTime;}; 

DWORD StopTime(){return m_dwStopTime;}; 

void Start(){ m_bRunning=TRUE; m_dwStartTime“timeGetTime();}; 
void Stop(){ m_bRunning-FALSE; m_dwStopTime-timeGetTime();}; 

DWORD Read(){ return (m_bRunning) ? timeGetTime()-m_dwStartTime : 

m_dwStopTime-m_dwStartTime;}; 
void Continue(){ m_bRunning=TRUE;); 

void Reset(){ m_bRunning-FALSE; m dwStartTime=OL; m dwStopTime-OL;}; 

}; 

lendif /* _CTIMER FILE_ */ 

/* End of File */ 
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Listing 3 timerdll.c - Source for timer support DLL 


#ifndef STRICT 

Idefine STRICT /* Use STRICT */ 

#endif 

#include <windows.h> 

♦include <mmsystem.h> 

♦include "timerdll.h" 

Idefine MAX_EVENTS 8 /* Our limit */ 

typedef struct tagMYEVENT{ 

UINT idCTimer; 

UINT idEvent; 

DWORD dwNotify; 

DWORD dwUser; 

WORD wMissed; 

WORD wType; 

JMYEVENT; 

static UINT MinimumResolution-5; 
static MYEVENT EventTable[MAX_EVENTS]; 

DWORD WINAPI NewEvent(UINT idCTimer, 

UINT wType, UINT wDelay, 

DWORD dwNotify, DWORD dwUser){ 

int i; 

for(i=0; i<MAX_EVENTS; i++) 
if(!EventTable[i].idEvent) 
break; 

if(i*=MAX_EVENTS) 
return OL; 

EventTable[i].idCTimer=idCTimer; 

EventTable[i].wMissed=0; 

EventTable[i].wType-wType; 

EventTable[i].dwNotify-dwNotify; 

EventTable[i].dwUser-dwUser; 

EventTable[i].idEvent-timeSetEvent(wDelay, 

1, TimeFunc, (DWORD)i, 

(wType & EVTBIT_0NESH0T) ? 

TIME_ONESHOT : TIME_PERIODIC); 

if(1EventTable[i].idEvent) 
return OL; 

return (DWORD)MAKELONG(EventTable[i].idEvent,idCTimer); 

} 

/* Return the index of the dwEventID. If 
invalid event then return a -1. */ 
int WINAPI EventGetIndex(DWORD dwEventID){ 
int i; 

UINT idCTimer; 

UINT idEvent; 

if(ldwEventlD) 
return -1; 

idCTimer=HIWORD(dwEventID); 
idEvent-LOWORD(dwEventlD); 
for(i“0; i< MAX_EVENTS; i++){ 

if(EventTable[i].idEvent -- idEvent && 

EventTable[i].idCTimer == idCTimer) 
return i; 

} 

return -1; 

} 

void WINAPI SetMinDllPeriod(UINT minRes){ 

MinimumResolution-minRes; 

} 

BOOL WINAPI EventClear(DWORD dwEventID){ 
int index; 

UINT status; 

index=EventGetIndex(dwEventID); 
if(index !- -1){ 

status- timeKi11 Event(LOWORD(dwEventlD)); 
EventTable[index].idEvent-0; 

EventTable[index).idCTimer=0; 
if(!status) 

return TRUE; 

} 

return FALSE; 

} 

/**** INTERRUPT - CODE **** 

This code executes at event time */ 


void CALLBACK TimeFunc(UINT wTimerlD, 

UINT wMsg, DWORD dwUser, 

DWORD dwl, DWORD dw2){ 

int i; 

void (FAR PASCAL *pFunc)(DWORD); 

i»(int) dwUser; /* Which event */ 

if(EventTable[i].wType & EVTBIT_CALLBACK){ 
pFunc-(void far*) EventTable[i].dwNotify; 

(*pFunc)(EventTable[i].dwUser); 

} 

else{ 

if(!PostMessage((HWND)LOWORD(EventTable[i].dwNotify), 
(UI NT)HIWORD(EventTable[1].dwNotify), 
(WPARAM)EventTable[i].wMissed, 

(LPARAM) EventTable[i].dwUser)) 
EventTable[i].wMissed++; 

else 

EventTable[i].wMissed=0; 


if(EventTable[i].wType & EVTBITPERIODIC) 
return; 

if(lEventTable[i].wMissed){ 

EventTable[i].idEvent«0; 

EventTable[i].idCTimer=0; 
return; 

} 

EventTable[i].idEvent-timeSetEvent(MinimumResolution, 
1, TimeFunc, dwUser, TIME_ONESHOT); 

return; 

} 

/* End of File */ 
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Coding the CTimer 

dimer.c (Listing 1) contains most of 
the source code to implement the C- 
Timer class. To use the class, just in¬ 
clude the header file dimer.h (Listing 
2), which contains the CTimer class dec¬ 
laration. The source code for the DLL, 
which you should compile separately, is 
i n timerdll.c (Listing 3) and 
timerdll.h (Listing 4). You can use the 
module definition file, timerdll.def 
(Listing 5), and the makefile in 


timerdll.mak (Listing 6) to create the 
DLL with Microsoft C/C++. 

dimer.c declares a static CTimer 
object named the PhantomTimer which 
is used to perform class initialization 
and cleanup. This prevents multiple in¬ 
itializations in the case where your ap¬ 
plication uses a single CTimer that fre¬ 
quently goes in and out of scope. You 
can eliminate this line from your code if 
you prefer. Most of the member vari¬ 
ables are protected, so you will be able 
to access them from any derived class. 
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Listing 4 timerdll.h — 

Interface for timer support 

DLL 




#ifndef 

TIMER DLL FILE 



#define 

_TIMER_DLL_FILE_ 



#define 

EVTBIT CALLBACK 

0x0001 


#define 

EVTBIT MESSAGE 

0x0002 


#define 

EVTBIT PERIODIC 

0x0004 


#define 

EVTBIT_ONESHOT 

0x0008 


#ifdef _ 
extern "C 

cpl usplus 

f 



#endif 




void CALLBACK TimeFunc(UINT, UINT, DWORD 
void WINAPI SetMinDUPeriod(UINT); 

, DWORD, DWORD); 

BOOL WINAPI EventClear(DWORD) 

» 


BOOL WINAPI EventGetlndex(DWORD); 

DWORD WINAPI NewEvent(UINT, UINT, UINT, 

DWORD, DWORD); 

#ifdef 

cplusplUS 



/ 

#endif 
#endif 1 * 

TimerDLL file */ 



/* End of 

File */ 




A few critical variables are private to provide some degree of 
robustness. 

The code for the DLL is ordinary C and is intentionally un¬ 
optimized to make it easier to understand and follow. The 
only section which really needs optimization is the Timer- 
Func(), which is executed at interrupt time. Only about half of 
the code in TimerFuncf) is executed during any given inter¬ 
rupt. Rather than use pointers, I used an index ( i) into the 


Development ToolsKan 


Windows Tools 

Visual Basic 
Windows SDK , ■& 


fur L'/C+v/fuscal & Visual Basic 


I Table 

-Column & row split windows 
-Multiple row & column selections 
-Check boxes/ radio buttons/ bitmaps/ 
editable & combobox column 
-Input Validation 
-Color customization 



I Status Bar 

-Auto scrolled text 
-Stretchable field width 
-Colored progress bar 
-Show date/time & key states 




3D Chart 


-Over 30 of 21) & 31) Chart styles 
-Rotation & Scrolling 
-Supports printing & clipboard 


I Toolbox 

-Creates buttons from bitmaps or text 
-Supports scrolling 
-31) buttons w/ color customization 
-Single/ multiple & no-state button 
groups 


I Ribbon / Icon Bar 

-3D items w/ color customization 
-Supports combobox, text & buttons 


I Field Validation 

-Validates date/time/number fields 
and "PIC" statements 


Optional with Source. Royalties Free. 30-Day MBG. 


I Meter Control 

-Creates vertical, horizontal and 
circular gauges with choice of 
needle or eolorr bar as indicators 
-Linear & Logorithmic scales 


Consulting & Contract Programming Available 
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Listing 5 timerdll.def — Module definition for timer 
support DLL 

LIBRARY TIMERDLL 


DESCRIPTION 'DLL for 

CTimer Events' 

EXETYPE WINDOWS 


CODE PRELOAD FIXED 

NONDISCARDABLE 

DATA PRELOAD FIXED 

NONDISCARDABLE 

HEAPSIZE 1024 


EXPORTS 


WEP 

@1 RESIDENTNAME 

TimeFunc 

@2 

NewEvent 

03 

EventClear 

@4 

EventGetlndex 

@5 

SetMinDllPeriod @6 


EventTable for simplicity. Fortunately, the value of i becomes 
invariant early in the function and optimizing compilers 
learned how to perform array subscript optimizations several 
years ago. The moral of the story is that it will compile better 
than it looks. 

Remember to link your application with mmsystem. lib and 
timerdll.lib. timerdll.lib is an import library for the 
timerdll.dll-, it is created automatically for you when you 
build the DLL. At runtime your application will also need 
msystem.dll, which is shipped and installed with Windows 
in the c:\windows\system directory. 

I find sample code and examples invaluable in learning 
how to actually use a class or function. The code disk (see the 
table of contents for availability) contains a complete sample 
application for demonstrating CTimer objects. Figure 2 shows 
the sample application in action. I wrote this application using 
Microsoft C++ and the MFC class library. The code disk also 
contains a more completely commented version of the source 
code presented here. 

windows 3.1 is far from being a realtime operating system, 
but the multimedia extension timing services do provide a 
useful alternative to the standard Windows timers. Encap¬ 
sulating these services as a C++ class can make them more 
attractive to use. With the CTimer class, you should be able to 
easily take advantage of high-resolution timing in your ap¬ 
plication. □ 


Listing 6 timerdll.mak — Makefile for timer support 
DLL 


CC = cl 
RESFLAGS=/30 

CFLAGS = /c /Gs /G2 /Zpl /W3 /ASu /Ox /DSTRICT 
LFLAGS - /NOLOGO /NOD /NOE /ALIGN:16 /0NERR0R:N0EXE 
LIBS = libw sdllcew mmsystem 
LINKER = link 

all: TimerDLL.dll 

TimerDLL.OBJ: TimerOLL.C TimerDLL.H 

$(CC) $(CFLAGS) TimerDLL.C 


TimerDLL.DLL: TimerDLL.obj TimerDLL.DEF 

$(LINKER) $(LFLAGS) TimerDLL.obj, TimerDLL.DLL,, S(LIBS), TimerDLL.def 
rc $(RESFLAGS) TimerDLL.DLL 
implib TimerDLL.LIB TimerDLL.DLL 
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Managing Memory 
in Windows NT DLLs 

Brian G. Myers 


Windows NT changes the rules for writing dynamic-link libraries. Although 
Microsoft has gone out of its way to preserve as much of the old Windows API as 
possible, some changes were inevitable. DLLs, for example, must now cope with 
protected address spaces and multithreaded clients. The compile and link com¬ 
mands, the module definition file, the entry point procedure, and memory allocation 
techniques have all changed. This article explains the changes, concentrating on the 
new ways to manage memory. 

Under 16-bit versions of Windows (Win 16), any variables a DLL declares are global 
to all callers, and one caller may interfere with values set for another caller unless 
you take special precautions. The danger arises because a DLL receives only one 
data segment to hold all the global and static variables used by any of its clients. 
Under 32-bit Windows, however, a DLL normally receives a new data segment for 
each new client. The fact that every process has a private address space prevents 
the different instances form conflicting with each other and eliminates the need to 
worry about multiple applications using the same data in your DLL. 

Other modifications to the compiler, the linker, and the API collectively give you a 
complete set of tools for controlling the scope of any variable or allocated block. 
Each can be made visible to all the library's clients, to just one client, or even to just 
a single thread within a client. 

Building a DLL for Windows NT 

I’ll begin with the new rules for building a DLL. A high percentage of the problems 
new Win32 developers experience with DLLs stem from difficulties with the build 
options and export mechanisms rather than from bugs in the actual code. Some of 
the advice in this section applies specifically to Microsoft's compiler. 

The New Entry Point Procedure 

Under Win16, you can view LibMain() as the entry point of the DLL, and you can 
count on the operating system calling UEP() just before it unloads your DLL. 


Brian Myers has written three Windows books for Sybex. The most recent, written 
with Eric Hamer, is Mastering Windows NT Programming, from which parts of this 
article derive. Brian has been consulting in the the industry since 1984, working often 
with Access Softek Microsoft designated him a recipient of this gear’s Most Valuable 
Professional award. He can be reached at bmyers@uclink.berkeley.edu. 
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Figure 1 Win32 DLL entry-point skeleton 


BOOL WINAPI Dll Main ( 

HINSTANCE hinstDLL, /* the DLL module */ 

DWORD dwReason, /* event code */ 

LPVOID IpReserved) /* not used */ 

( 

switch (dwReason) 

f 

case DLL_PROCESS_ATTACH: 

/* a process is loading the DLL */ 
break; 

case DLL_THREAD_ATTACH: 

/* a process created a new thread */ 
break; 

case DLL_THREAD_DETACH: 

/* a thread ended */ 
break; 

case DLL_PROCESS_DETACH: 

/* a process is freeing the DLL */ 
break; 

) 

return(TRUE); 

) 


These two calls let the library perform housekeeping 
chores as each new client summons or dismisses it. Win32 
replaces LibMain() and UEP() with a single routine to 
respond whenever any thread or process uses or frees the 
library. The procedure is conventionally called DllMainf). 


(During NT beta testing it was usually DllEntryPointO). The 
procedure may have any name, but it must conform to the 
prototype shown in Figure 1. 

DllMainO's first parameter is a handle to the DLL module. 
If other procedures in your library have any use for the hand¬ 
le, you should save it in a global variable because calling Get- 
ModuleHandle() from a DLL returns the handle for the client 
program, not for the DLL. The next parameter, dwReason, iden¬ 
tifies the reason for calling the entry point. It may be one of 
the four values you see in the switch statement. A DLL is not 
obligated to respond to all the possible values of dwReason. It 
can choose to handle some and ignore others. DllMainQ 
returns a Boolean value, but the value matters only after 
DLL_PROCESS_A TTACH. If for any reason a DLL cannot complete 
necessary initialization tasks, it should return FALSE. The 
DLL_ THREAD_A TTACH call lets the entry point initialize separate¬ 
ly for individual threads. In a multidocument program, for ex¬ 
ample, which might create a new thread for each document 
window, a DLL might need to initialize a distinct data set for 
each thread. 

A process's primary thread — the one that Win32 launches 
first — never generates a DLL_THREAD_ATTACH signal. In order 
to perform the same initialization for the primary thread as for 
other threads, you could omit the break statement from the 
DLL_PROCESS_ATTACH case and fall through to the 
DLL_THREAD_ATTACH case. Also, a DLL receives DLL_THREAD_AT- 
TACH signals only for threads created after the library is at¬ 
tached. A potential problem arises in clients that load the DLL 
dynamically using LoadLibraryO and GetProcAddress(). Any 
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At Your Fingertips. * * 

MKS Ioolkit—All the Tools of the Trade for Professional 
Programmers and Application Developers. 

MKS Toolkit puts a powerful suite of easy-to-use development utilities within your 
grasp. Developers working on DOS can now get the extraordinary power of 
tools that were once available only on UNIX, and still switch quickly back 
to DOS applications. For multi-platform environments, MKS Toolkit is 
fully compatible with UNIX systems, and tracks both POSIX and x/Open standards. 

Start shaping the applications of the future! Call now to order your copy 
of MKS Toolkit. 


Some of the 180+ utilities in MKS Toolkit 4.1 


• A new, easy-to-use, efficient UUCP 
communications package. * 

• MKS AWK, the fast prototyping language 
now with a new AWK compiler. 

• MKS KornShell, the full-featured 
programming language. 

• MKS Make, the software construction 
utility. 


• MKS Vi, the full-screen editor. 

• New Windows icons. 

> Full on-line reference manual. 

• Interoperability with Open VMS, CTOS 
and MPE/iX. 
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compression, archiving, file processing 
and customizing your PC environment. 


MKS 

35 King St. V, Waterloo, ON. Canada N2J 2W9 


Price: $299, Upgrade $99. Call for multi-user pricing , 

30 day money back guarantee. 

For information on how to order, call MKS at: 

1-800-265-2797 (US and Canada) or (519) 884-2251 • Fax (519) 884-8861 

* MKS UUCP not available on NT and OS/2. 

MKS and MKS Toolkit. MKS KornShell, MKS AWK, MKS Make. MKS UUCP and MKS Vi are trademarks of Mortice Kern Systems. Inc., 
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Figure 2 Revised entry-point for use with C runtime library 

BOOL WINAPI CRT INIT(HINSTANCE hinstDLL, 

case DLL THREAD ATTACH: 

DWORD dwReason, LPV0ID 1pvReserved); 

_CRT_INIT(hinstDLL, dwReason, IpReserved); 

MyInitThread( ); 

BOOL WINAPI D11EntryPoint(HINSTANCE hinstDLL, 

break; 

DWORD dwReason, LPVOID IpReserved) 


1 

/* When detaching, call the routines in */ 

switch (dwReason) 

{ 

case DLL PROCESS ATTACH: 

/* reverse order, your own first. */ 

case DLL THREAD DETACH: 


MyDetachThread( ); 

/* Initialize the C library first. */ 

CRT INIT(hinstDLL, dwReason, IpReserved); 

if (! CRT INIT(hinstDLL, dwReason, 

break; 

IpReserved)) { 


return(FALSE); 

case DLL PROCESS DETACH: 

) 

MyDetachProc( ); 

if (!MyInitProc( )) { 

CRT INIT(hinstDLL, dwReason, IpReserved); 

return(FALSE); 

\ 

break; 

/ 

break; 

/ 

return(TRUE); 

1 


thread can call DLL routines, but threads created before the 
LoadLibraryO call do not generate DLL_THREAD_ATTACH sig¬ 
nals. 

Unfortunately, you cannot be absolutely certain that all the 
expected DETACH messages will arrive. For example, the Win32 
functions TeminateProcess () and TerminateThread() both 
kill their targets immediately without notifying libraries. If a 
library’s client is rudely terminated, any data the library holds 
for the client remains allocated until all the library’s other 
clients also detach or terminate. 

The entry point procedure is optional. A DLL that requires 
no housekeeping (a resource-only DLL, for example) is not 
obliged to supply an entry point. 

The C runtime libraries contain their own internal entry 
point, called _CRT_INIT(), to initialize internal data for threads 
and processes. During the NT beta testing period, program¬ 
mers were advised to call _CRT_INIT() directly within the 
entry procedure of any DLL that used the C runtime libraries. 


Listing 1 makefile for building debugging versions 
of DLL 


all: test.exe sections.dll 
test.exe: test.obj sections.lib 
sections.lib: sections.obj sections.def 
sections.dll: sections.obj sections.exp 

CFLAGS = -c -Od -W4 -Zi -D_X86_=1 -DWIN32 -D_MT -D_DLL 
LFLAGS = -debug:full -debugtype:cv 
SUBSYS = -subsystem:console 
LIBS = crtdll.lib 

•c.obj: 

cl386 $(CFLAGS) $*.c 
■obj.lib: 

lib32 -machine:$(CPU) $*.obj -out:$*.1ib -def:$*.def 
•obj.exe: 

link32 $(LFLAGS) $(SUBSYS) -out:$*.exe $*.obj \ 

$(LIBS) sections.lib 

•obj.dll: 

link32 $(LFLAGS) -DLL -entry:_DllMainCRTStartup@12 \ 
-out:)*.dll $*.obj $*.exp $(LIBS) 


Figure 2 shows how to call _CRT_INIT(). Make sure you in¬ 
clude a prototype of the function and mark it with the WINAPI 
modifier; if you don’t, the linker will fail to resolve the call. 

With the retail release of the Win32 SDK, Microsoft devised 
a less cumbersome method. Where you once had to initialize 
the C library, the C library now initializes you. Simply name 
your own entry point DllMoin() and tell the linker to use the 
entry point named _DllMainCRTStartup(). This alternate C 
library entry point calls the built-in _CRT_INIT() and then 
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Table 1 

Library 

Features 

Compiler Switches 

libc 

standard 

none 

libcmt 

multithreading 

-D MT 

crtdll 

multithreading (_MT) and 

-D_MT 


dynamic (_DLL) linking 

-D_DLL 


Listing 2 sections.c — Library to count number of 
threads/processes that attach 


SECTIONS.C 

A library that counts the number of threads 
and processes that attach themselves to it. 


linclude <windows.h> 
linclude <stdio.h> 
linclude "sections.h" 


GLOBAL VARIABLES 

uNumClients 

uNumThreadsGlobal 

uNumThreadsLocal 


total number of processes 
total number of threads 
total threads from the 
current process only 


Ipragma data_seg( ".Global" ) 
UINT uNumClients = 0; 


/* SHARED section */ 


calls the function named DllMain() if 
you have supplied it (see Listings 1 and 
2 for examples of the new method). 
DLLs that do not call C runtime routines 
should forget about 
_DllMainCRTStartup() and tell the 
linker to use DllMain() itself as the 
entry point. 

Exporting Procedures 

In a flat, unsegmented address space, any function can call 
any other without worrying about near and far segments. The 
short assembly prolog formerly added to all callback and ex¬ 
ported procedures no longer serves a purpose — another 
bump smoothed out by the flat memory model. Callback pro¬ 
cedures do not need to be exported, MakeProcInstance() 

now does nothing, and the_ export keyword is obsolete in 

Win32. The functions in a DLL do still need to be exported, 
however, in order for the system to create header tables 
within the DLL image. To export a function, it is enough just to 
list it in the .def file under the EXPORTS section. 

(Users of the forthcoming 32-bit Visual C++ will be able to 

avoid .def files entirely by using the new_ declspec 

keyword to designate dllexport and dllimport storage clas¬ 
ses. Presumably, a later release of the Win32 SDK will support 
this option, too.) 

The .def File 

Even when dllimport and dllexport are available, you 
might choose to export through a module definition file so 
that you can call functions more efficiently by assigning them 
an ordinal number. A typical . def file might look like this: 


Tired of juggling with your 
serial port problems? 



Losing serial characters because of 
Windows" interrupt latencies? Are your 
comm applications running unbearably 
slow? Juggling a little code here, fiddling 
with an ISR there, and trying again? 


There's a better solution: 

COMMtelligence’ 





This RS232/RS485 board has a PC-compatible 
CPU dedicated to servicing interrupts from its 
four serial ports. Dual-port RAM, resident 
firmware, and 512K of RAM provide deeply 
buffered serial data to your Windows or DOS 
program - with no missing data. 

To supercharge applications, download custom programs 
onto the COMMtelligence board to perform protocol 
conversion, polling, or other front-end processing tasks. 

So quit juggling with your serial port problems. Get your 
application going by calling or FAXing for details today. 


^DRUMLIN 


3447 Ocean View. Glendale, CA 91208 


Phone 

FAX 


(818) 244-4600 
(818) 244-4246 
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Win32 DLL Troubleshooting 

• Are the client and the library linked to the same 
version of the C runtime library? 

• If the library calls C runtime routines, have you 
named the entry point DllMain and told the linker 
that _DllMafnCRTStartup is the entry point? 

• Have you added @12 to the entry point name on 
the linker command line? 

• If the program calls _CRT_INIT, have you provided a 
correct prototype, including the WiNAPI (or 
_stdcall) calling convention? 

• If the library's clients are multithreading, have you 
linked to a multithreading version of the C runtime 
library (either Z ibcmt. I ib or crtdl l. I ib)l Have you 
defined _MT on the compiler command line? 

• If the library links to crtdll.lib, have you defined 
_DLL on the compiler command line? 

• If you have named any data sections using Hpragma 
data_seg(), have you assigned names of no more 
than eight characters including the leading period? 

• If you are using shared (public) data, are the public 
variables initialized? □ 
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Table 2 Memory allocation methods for Win32DLLs 



Public to All Processes 

Private to One Process 

Private to One Thread 

Static 

#pragma data segO 

variables 

declspec(thread) 

Dynamic 

memory-mapped file 

GlobalAllocO 

TIsAllocO 



HeapAllocO 




VirtualAllocO 



LIBRARY MyLib BASE 0x400000000 
EXPORTS 

AFunction @1 

AnotherFunction @2 

The optional BASE keyword suggests a loading address for the 
DLL. When a program invokes the DLL, the system tries to 
place the library at the suggested location in the caller’s 32-bit 
virtual address space. If that location is already occupied, how¬ 
ever, the system simply puts the library somewhere else. The 
only advantage of suggesting a base address is speed. Normal¬ 
ly, the linker cannot know in advance where in memory a DLL 
will reside, so at runtime it must look up the current location 
of all the DLL procedures and copy the addresses into the 
client program's code. When you request a base address, the 
linker pencils in tentative addresses in advance. If the system 
manages to load the DLL at the requested location, then it can 
skip the lookup process and leave the tentative addresses in¬ 
tact. 

The choice of a BASE address is arbitrary. The address must 
fall in the lower 2Gb of the 4Gb virtual address space that 
every NT process receives, in the range 0x00010000 - 0X7FFEF- 
FFF. Within that range, very high and low addresses are likely 
to be occupied by the program itself or by the system DLLs. 
Use the middle of the range, and when a program calls 
several DLLs simultaneously, set the BASE addresses far 
enough apart to be sure the file images don't overlap in 
memory. If an overlap or collision does occur, the only penalty 
is less efficient loading. 

Compiling and Linking a DLL 

Building a DLL requires three tools: the compiler, the linker, 
and the library manager. In Microsoft’s SDK, these tools are 
CL386, Link32, and Lib32. Compiling a DLL is no different than 
compiling an executable file, but linking does require some 
new switches. 

Run the library manager before the linker to create an ex¬ 
port library. The linker learns about exported procedures from 
the export library, not from the .def file. In fact, Link32 never 
reads any .def file; only Lib32 does. A single run of Lib32 
produces both an export library (.exp) and an import library 
(.lib). The export library is used only once, when the linker 
builds the DLL. Like .obj, .res, and .rbj files, the .exp file is 
an intermediate byproduct, of no use after the DLL is con¬ 
structed. The import library, on the other hand, is used in 
building every program that calls the DLL. This command 
generates both libraries for MyDIL 

(continued on page 38) 


Listing 2 continued 


UINT uNumThreadsGlobal = 0; 

#pragma data_seg( ".Local" ) /* PRIVATE section */ 

UINT uNumThreadsLocal = 0; 

Ipragma data_seg( ) /* restore default */ 


BOOL WINAPI DllMain(HINSTANCE hinstDLL, 

DWORD dwReason, LPVOID IpReserved) 

{ 

switch (dwReason) 

{ 

case DLL_PR0CESS_ATTACH: 
uNumClients++; 

/* fall through for the primary thread */ 

case DLL_THREAD_ATTACH: 
uNumThreadsLocal ++; 


How Can You Catch Nasty 
Race Conditions That Take All 
Night to Happen Without 
Waiting All Night? 
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captures, time-stamps, and records software and hardware 
interrupts, DOS calls, BIOS interrupts, and user-defined 
events in real-time for analysis of race conditions, 
interrupt activity, and service times. CodeProbe gives you 
the hard facts you need to fix the big one that stands 
between system test and shipping your product. 
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Figure 1. Detailed timestamping otC library freadf) function call. 

If CodeProbe can break-down a library function call into 
its components (above), imagine how you'll see context 
switches, device interrupts, and other asynchronous code. 

Call today for free technical specifications! 
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Listing 2 continued 

uNumThreadsGlobal++; 

break; 


case DLL_THREAD_DETACH: 
uNumThreadsLocal 
uNumThreadsGlobal--; 
break; 


case DLl_PR0CESS_DETACH: 
uNumClients--; 
break; 


1 

return(TRUE); 

1 


EXPORTED FUNCTIONS 

.— */ 

UINT GetNumClients(void) 


l 

return(uNumClients); 

} 


UINT GetNumThreadsLocal(void) 


I 

return(uNumThreadsLocal); 

} 


UINT G^tNumThreadsGlobal(void) 


l 

return(uNumThreadsGlobal); 

} 


/* End of File */ 
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lib32 -machine:i386 -deftmydl1.def \ 

-outtmydl1.1ib mydll.obj 

Linking a DLL requires a new command line switch, -dll, tell¬ 
ing the linker not to produce an executable file. In addition, 
the -entry switch must name the DLL’s entry point proce¬ 
dure; the -out switch receives a name with a .dll extension 
instead of . exe-, and the export library must appear with the 
object files. 

Tink32 -machine:!386 -dll -out:mydll.dll \ 

-entry:_DllMainCRTStartup@12 \ 

mydll.exp mydll.obj mydll.rbj \ 

libc.lib kernel32.lib 

The entry point name acquires three extra characters (“@12”) 
because the linker needs to see the name in its decorated 
form. The_sfdcaZZ calling convention appends to each proce¬ 
dure name the number of bytes required for all the 
parameters. DllMain() takes a handle, a pointer, and a DWORD, 
so its parameters fill twelve bytes. A DLL may omit the -entry 
switch if it has no entry point of its own and does not call any 
C runtime routines. 

The Three C Runtime Libraries 

Windows 3.x C compilers require you to link a DLL with 
special versions of the C runtime library that do not assume 
the stack and data segments are equal. Since Win32 
eliminates segments and offers a flat, 32-bit address space, 
that problem disappears and programs and DLLs link with the 
same C runtime libraries. The concept of memory models also 
disappears, further reducing the complexity of building a DLL. 
However, the Win32 SDK still comes with three different ver¬ 
sions of the C runtime library: libc, libcmt, and crtdll. The 
three 32-bit C libraries differ in their linking mechanism and 
their support for multithreading. Table 1 contrasts their fea¬ 
tures. 

libc.lib provides the traditional runtime support library 
familiar to C programmers, libcmt. lib also links statically, but 
all its routines are re-entrant to support multithreading. There¬ 
fore, if your DLL might be called by a multithreading program, 
you should link with libcmt. lib or crtdll. lib and add the 
-D_MT switch to your compiler command line. Some of the C 
header files alter their declarations for multithreading when 
_MT is defined. 

Linking statically to a C library sometimes causes problems 
for DLLs. For example, if a DLL and its client application both 
call printf(), and both link to either libc. lib or libcmt. lib, 
then the printff) code is copied redundantly into both the 
DLL and the client. Duplicated code is merely inefficient; a 
more serious problem is that the C routines in the client do 
not share internal data with C routines in the DLL. If, for ex¬ 
ample, something goes wrong in the DLL, the client cannot 
report the problem by calling perror() because the client has 
a different copy of the errno variable. Similar problems arise if 
the client and the library try to share handles to buffered 1/0 
streams, or if one allocates memory with malloc() and the 
other tries to free it. 
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Linking with crtdll.lib solves both problems, crtdll.lib 
is a new DLL version of the standard C runtime library. 
Through this DLL, a library and its callers may share a single 
instance of the internal runtime data. To use crtdll.lib, set 
two switches for the compiler: -D_MT for multithreading and 
-D_DLL for dynamic linking. The _DLL symbol is required for 
any modules (programs or libraries) that link with crtdll.lib. 

DLL indicates that you are linking to a DLL, not that you are 
trying to create one. The only catch in linking a DLL to 
crtdll.lib is that all the DLL’s clients must also link with 
crtdl l. lib, or you will get unpredictable results. 

The makefile in Listing 1 incorporates all the build rules 
into a sample makefile for a multithreading DLL and a pro¬ 
gram to call the DLL. The sidebar, "Win32 DLL Troubleshoot- 
ing,” presents a checklist of 
troubleshooting tips for building DLLs. 

Managing Memory 

A Win32 programmer can decide 
whether each variable should be visible 
to all the library’s clients, to just one 
client, or even to just a single thread 
within a client. At each level of visibility, 
memory objects can be static or 
dynamic. By a combination of .def file 
directives, compiler pragmas, variable 
storage classifiers, thread-local indexes, 
memory-mapped files, and conventional 
allocation functions, a DLL can arrange 
memory six different ways: statically or 
dynamically for one thread, one 
process, or all processes. Table 2 
schematizes the possibilities. 

Unfortunately, C and C++ have over¬ 
loaded meanings for words like “static,” 
and there are no universally agreed 
upon terms for describing the visibility 
of variables in a shared library environ¬ 
ment. This article applies the terms 
“public” and "private” to the problem. 

For example, 1 will refer to global vari¬ 
ables in Windows 3.x DLLs as “public," 
because Windows creates only a single 
instance of such variables (a single data 
segment), which is then shared among 
all the applications that call functions in 
that DLL. “Private,” then, means a 
private copy of a variable, one that is 
not shared. In this context, “public" and 
"private” do not refer to scopes of vari¬ 
able names. For example, a Win32 DLL 
may have a public variable that is not 
exported, and is therefore not directly 
visible to the client applications that ac¬ 
cess the DLL. 

Making Variables Public 

By default, Win32 DLL variables are 
private because the operating system 


creates a fresh set of such variables for each new application 
that accesses the DLL. A newly revised compiler pragma, how¬ 
ever, lets you group variables into sections that you can make 
either public or private. The following lines declare two vari¬ 
ables, each in a different section: 

#pragma dataseg( ".Global" ) 

UINT A_Public_Number = 0; 
fpragma dataseg( ".Local" ) 

UINT A_Private_Number = 0; 

#pragma dataseg( ) 

The first section is named “.Global” and the second “.Local." In 
Win32 programming, data section names conventionally begin 
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Listing 3 sections.def — Module definition file for 

sections.c 


LIBRARY 

SECTIONS 

.Global READ WRITE SHARED 
.Local READ WRITE 

EXPORTS 

GetNumCl i ents @1 

GetNumThreadsLocal @2 
GetNumThreadsGlobal @3 


Listing 4 share.c — 
global buffer 

Demonstration of shared 

#include <windows.h> 
#include <stdio.h> 

#include "share.h" 


Idefine BUFFER_SIZE 

0x100000 

PV0ID SharedAlloc(DWORD dwBytes); 
void SharedFree(PV0ID pView); 

Ipragma data seg(".Public") 
DWORD dwOffset = 0; 

#pragma data_seg() 

/* position in buffer */ 

PSTR pBase; 

HANDLE hFileMapping; 

HANDLE hmxMappedFile; 

/* bottom of buffer */ 

/* shared memory */ 

/* protects buffer */ 


with a period so that they can be distinguished easily from 
code sections, which begin with an underscore (“-data" and 
“_code”). In the beta versions, section names were limited to 
eight characters, but the release version overcomes the limit. 
It is still true, however, that variables in a public data section 
must be initialized explicitly. If the preceding lines of code 
failed to set A_Public_Number equal to zero, the variable 
would remain private even though the section is public. 

The example lines only name data sections; they do not 
change the memory attributes (such as whether the data is 
public or private) of either section. That must happen in the 
.def file under the SECTIONS Keyword (or on the linker com¬ 
mand line with the -section switch.) 

LIBRARY MyDll 
SECTIONS 

.Global READ WRITE SHARED 

.Local READ WRITE 

Strictly speaking, the declaration for “.Local” is unnecessary be¬ 
cause it merely reiterates the default attributes. Incidentally, 
the old SEGMENTS keyword has no purpose in the unseg¬ 
mented architecture of Windows NT. For compatibility, the 
Library Manager interprets SEGMENTS to mean SECTIONS. Also, 
the old DATA statement no longer has the power to change 
the default data attributes. This line has no effect: 

DATA READ WRITE SHARED 
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Listing 4 continued 


/* thread-local storage for client thread IDs 
_declspec(thread) DWORD dwThreadID; 


/*. 

DLL MAIN 


BOOL WINAPI D11 Main(HINSTANCE hinstDLL, 
DWORD dwReason, LPVOID IpReserved) 

l 

switch (dwReason) 

{ 

case DLL PROCESS ATTACH: 


.*/ 
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You have to describe each shared section individually. 

When porting a Win 16 DLL to Win32, you can avoid some 
of the trouble of adjusting to private variables by marking a 
single data section for the whole library and declaring it 
public. The same strategy helps in writing Win32s code that 
also works under Windows NT. Variables in a Win32s DLL, like 
those in Win16 DLLs, are public (For private variables under 
Win32s, use TlsAllocO, descussed later.) 

Even though the data_seg pragma makes it easy to share 
variables through a DLL, it is not always profitable to do so. 
Many variables are useless when shared — particularly 
pointers and handles. You can’t, for example, declare a public 
IpGlobal variable and expert to share the buffer it names. 
The value placed in IpGlobal will be a virtual address from 
the process that was active when the 
DLL allocated the buffer. Other proces¬ 
ses might be able to retrieve the 
pointer value stored in IpGlobal, but 
the allocated object doesn't exist in 
their address spaces, and for them Ip¬ 
Global dangerously points to a random 
location. You should also note that 
while Win16 lets you allocate shared 
memory by passing GMEM_SHARE to 
GlobalAllocf), GlobalAlloc() does 
not allocate shared memory under 
Win32, which creates another porting 
problem for Win 16 DLLs. Handles, too, 
are invalid except in the process where 
they originate. 
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An Example of Public 
and Private Data Sections 

sections.c (Listing 2) and sec¬ 
tions.def (Listing 3) demonstrate the 
DLL features I’ve explained so far, in¬ 
cluding the entry point procedure and 
public variables. The library merely 
counts the number of processes and 
threads that attach themselves to it. It 
creates both a public and a private sec¬ 
tion in order to keep a local total for 
individual callers and global totals for all 
callers. The exported GetNumClients() 
routine works as advertised only be¬ 
cause the DLL declares its “.Global” data 
section to be SHARED. If the data section 
were private and each caller had its 
own copy of uNumClients, then Get¬ 
NumClients () would always return 1. 
The complete code (see the table of 
contents page for code availability) in¬ 
cludes a sample client that calls the DLL 
and prints the totals. With three instan¬ 
ces of the client running, the output 
looks like this: 
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clients: 3 
threads local: 1 
threads global: 3 

Advanced Memory Management 

My second DLL example dynamically allocates a public 
buffer for all its clients to share. The source is in share, c (List¬ 
ing 4) and share.def (Listing 5). Clients call a library routine to 
copy data into the buffer and another to display the contents 
of the buffer on the standard output device. As the library 
copies each new string to the buffer, it automatically prefixes 
a thread ID number to identify the source of the string. Al¬ 
locating the buffer dynamically requires a memory-mapped 
file. Storing an ID for each thread requires thread-local storage 
(TLS). Before turning to the source code, I’ll explain generally 
how to use these features in the context of a DLL. 

Allocating Public Memory Dynamically 

Like variables, dynamically allocated memory buffers are 
private by default under Windows NT. The values returned by 
functions such as VirtualAlloc(), GlobalAllocO , and mal- 
loc() always refer to private objects. Any particular chunk of 
memory must be mapped into some address space, and the 
DLL does not have one of its own. Even setting the 
GMEM_DDESHARE flag makes no difference; the memory is still 
private to the process that allocated it. 

In order to allocate at runtime a buffer of shared data for 
several clients, a Win32 DLL must resort to the same means 
that any Win32 process would use: memory-mapped files. A 
thorough explanation of memory-mapped files is beyond the 
scope of this article, but, briefly, memory mapping is a 
mechanism for making one block of physical memory visible 
in several address spaces. The block may appear at different 
addresses in different spaces, but its contents are the same 
for all processes. CreateFileMapping() establishes the block 
of physical memory and MapViewOfFile() makes the block 
visible to one process. Processes share memory when several 
of them map views of the same block. 

It may sound odd to use memory-mapped files to imple¬ 
ment shared memory, but consider the fact that Windows NT 
is a virtual memory operating system, where most any 
memory can be swapped out to disk. In fact, you could refer 
to the swap file as a memory-mapped file. Note that creating 
a memory-mapped file does not imply that Win32 has to ac¬ 
cess the file to access the memory. As with the rest of virtual 
memory, whether file I/O is actually required depends on the 
swapping algorithm and the amount of available physical 
memory. 

The Share DLL creates one file-mapping object and maps it 
into the address space of each new client. This kind of “file 
mapping" actually has very little to do with files. In effect, the 
combination of CreateFileMapping() and MapViewOfFile() 
simply allocates a buffer that can become visible to other 
processes. The Share DLL packages the two calls in a single 
procedure named SharedAlloc(). When different processes 
call SharedAllocO, they receive different pointers to the 
same block of memory. A corresponding Shared Free () routine 
releases the shared buffer. (The system doesn’t actually destroy 


Listing 4 continued 


/* get a pointer to the shared buffer */ 
pBase = (PSTR)SharedAl1oc(BUFFER_SIZE); 
if (!pBase) ( 
return(FALSE); 

) 

/* fall through for primary thread */ 

case DLL_THREAD_ATTACH: 

dwThreadID = GetCurrentThreadId( ); 
break; 

case DLL_PROCESS_DETACH: 

SharedFree(pBase); 
break; 

1 

return(TRUE); 

) 

/*. 

ADD STRING 

Determine the next empty byte in the buffer 
and copy a string there. 

. */ 

BOOL AddString(PSTR plnput) 

( 

PSTR pNext; /* next empty space in buffer */ 

char szDataString[256]; /* thread ID + input */ 

UINT uLength; /* byte count of szDataString */ 

/* merge thread ID and data into one string */ 
wsprintf(szDataString, "[%lu] %s", 
dwThreadID, plnput); 
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Listing 4 continued 


uLength = lstrlen(szDataString) + 1; 

/* Wait in line to use the buffer. */ 
WaitForSingleObject(hmxMappedFi le, INFINITE); 

/* If the buffer is too small, stop. */ 
if ((dwOffset + uLength) > BUFFER_SIZE) { 

ReleaseMutex(hmxMappedFi1e); 
return(FALSE); 

} 

/* Copy the string into the buffer. */ 
pNext = pBase + dwOffset; 
lstrcpy(pNext, szDataString); 

/* Make dwOffset point to the next empty space. */ 
dwOffset += uLength; 

ReleaseMutex(hmxMappedFile); 
return( TRUE ); 


SHOW ALL STRINGS 

Dump all the strings in the buffer to stdout. 
.---.*/ 

void ShowAl1 Strings(void) 

{ 

PSTR pCurrent = pBase; 

PSTR pEnd = pBase + dwOffset; 

while (pCurrent < pEnd) { 
puts(pCurrent); 

pCurrent += lstrlen(pCurrent) + 1; 

} 

} 
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the mapped buffer until all the processes using it have called 
Shared Free ().) 

Private Data for One Thread 

Private variables in a DLL protea callers from interfering 
with each other. The actions of one client cannot interfere 
with values stored for another client. Multiple threads within a 
single client have the same destruaive potential. The actions 
of one thread could interfere with values stored in the global 
variables it shares with other threads. One solution is thread- 
local storage (TLS), a way of making the system reduplicate a 
variable for each new thread. 

You can make any static variable be thread-local by 
declaring it with a storage class modifier: 

_declspec(thread) UINT uMostRecentError; 

That declaration causes the system to produce a new instance 
of the uMostRecentError variable for every thread in the 
process. Each thread can see only the value it stores there; 
the values stored in the same variable by other threads are 
visible only to those other threads. The Win32 command Get- 
LastError() probably relies on a similar thread-local variable 
within the Win32 subsystem in order to remember the most 
recent error for each thread. (Unlike dllexport, the thread 

argument of the_ declspec keyword is fully implemented in 

the final release of the Win32 SDK.) 

A little-known faa about thread-local storage may trip up 

DLL programmers:_ declspec(thread) does not work with 

LoadLibrary. A library that uses_ declspec for TLS must load 

implicitly (meaning it must be linked directly to the client). 

To create thread-local storage in explicitly loaded DLLs, use 
the TLS functions: TlsAlloc(), TlsSetValue(), TlsGet- 
Value(), and TlsFree(). They are more cumbersome than 
_declspec but also more flexible, easily able to manage 
dynamic allocations for individual threads. In cases where the 
thread-local data cannot be handled in a variable, use the TLS 
funaions to dynamically allocate storage dynamically. 

Sample: The Global Buffer Library 

share.c allocates a shared buffer to fill with strings that 
clients pass in. A public variable, dwOffset, maintains a high- 
water mark indicating the next available space in the buffer. 
Once the buffer is full, further attempts to add strings simply 
fail. A thread-local variable, dwThreadID, stores the system ID 
number for each new thread that attaches to the DLL. Every 
string in the buffer is stamped with the ID number of its 
thread. AddStringO writes data to the buffer and ShowAll- 
Strings() displays the data in the buffer. In a program that 
created threads numbered 147 and 158, ShowAllStrings() 
would print data strings like these: 

[147] entry #0 
[147] entry #1 
[158] entry #0 
[147] entry #2 
[158] entry #1 
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386BSD Version 0.1 & LINUX Version 0.96 (two Unix clones for Intel 386) .$100 

PC/IP (CMU/MIT TCP/IP for PCs; Crynwr drivers, NFS server, Bdale mailer, PCRoute/PCBridge, NDIS/ODI drivers, Beholder, more) . . . $100 

DA (disassembler for Microsoft’s New Executable (NE) binary files including Windows .exe, .drv, .dll, and .fit).$95 

Script Interpreter (a command script interpreter for DOS-based systems; C-fike script language; lots of features).$90 

CELP 3.2c (Federal Standard 1016 Code Excited Linear Predictive voice sampling and encoding; voice over 4.8kbps).$80 

CPPCOMM (C+ + serial communications class library for DOS, Windows, OS/2, and NT; includes X/Y/Zmodem).$75 

ET Neural Net (back error propagation and Kohonen; specify DOS text, DOS VGS, or Windows).$75 
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Smalltalk for DOS (port of GNU Smalltalk using djgcc).$60 
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Coder’s Prolog (Version 3.0; inference engine for use with C programs).$60 

PCCTS (Purdue Compiler Construction Tool Set; ported to Microsoft Q like YACC and LEX together with lots of additional features) . . . $60 

Container Lite V 1.82 (C+ + & FLC wrapper emulators; portable, persistent containers of arbitrary data including pointers).$50 

BigFloat (arbitrary precision floating point arithmetic and functions; includes BCD conversion).$50 

EZCalc (ASCII algebraic expression evaluator, unlimited parenthesis nesting, symbols, 32 built-in functions, easily extended).$50 

Backup & Restore Utility by Blake McBride (multiple volumes, file compression & encryption).$50 

CLIPS Version 6.0 (rule-based expert system generator, Windows compatible; hardcopy manuals additional).$50 

SuperGrep (exceptionally fast, revolutionary text searching algorithm; also searches sub-directories).$50 

Moby Crypto (PGP, DES, Secure Hash, UFC, MDs, Crack 4.1, Lucifer, IDEA, VCR+, large interger packs, tutorials, more; not for export) . $150 

OBJASM (convert .obi files to .asm files; output is MASM compatible) .$50 

NIH Oass Library & Book (basic CH—|- classes & Data Abstraction and Object-Oriented Programming in C+ + in softback by Keith Gorlen) $50 

Editor Pack (20 public domain editors; micromacs 3.12, Stevie, Elvis, Moke, mg2a, DTE, Jove, Origami, CE & GRIEF).$50 

MicroC C Compiler (retargetable C compiler/optimizer, lots of docs, very portable, 8086 tables included; tables for 7 extra epu’s $50) .... $50 

Exceptions for C (Ada-like exception handling for C programs; exceptions for any block; exceptions can be reraised).$45 

TOUR (beautiful traveling salesman problem solver, finds minimum length paths quickly, includes graphics & plotting programs) .$40 

DES Encryption & Decryption (2500 bits/second on 4.77 MHz PC for on-the-fly encryption at 2400 baud; not for export) . . ..$40 

APL for DOS (full implementation in C, uses ASCII character set).$40 

Database Pack (9 databases - simple to complex: isam, bplus, AVL, SDB, ID, gdbm, Requiem, Ingres89, Postgres).$35 

COP (poor man’s C++; C macro package which implements C+ + in C) .$35 

RXC & EGREP Version Z0 (Regular Expression Compiler and Pattern Matching; finite state machine from regular expression).$35 

Bison & BYACC (YACC workalike parser generators; documentation; includes C and C++ grammars) .$35 

Spell Pack (6 spelling programs, a hyphenator, 2 utility packs and a 60K word list: Ispell, Microsp, Sp, Cspella, Spell, Dawg, Soundex) .... $30 

REGX Plus (Version 3.0, search and replace string manipulation routines based on compiled regular expressions).$30 

GNU Awk & Diff for PC (both programs in one package).$30 

Big Number Pack (7 arbitrary precision arithmetic packages in C, one in Fortran but free Fortran-to-C converter is included) .$30 

Crunch Pack (30 file compression & expansion programs; now includes portable ZIP).$30 

OEmacs (full GNU Emacs for DOS and Windows DOS box; C+ + support, etags+ +, lots of .el files) .$25 

UUPC Pack (UUCP for the PQ UUPC Version 1.11V, smail & snews) .$25 

PERL for MS-DOS (Version 4.019; C, sed, awk, and shell all rolled into one language; includes hardcopy docs).$25 

FLEX (fast lexical analyzer generator, new, improved LEX; BSD Version Z3.6 with docs).$25 

GNU RCS (FSFs version of the Revision Control System; like Unix's SCCS only better; keeps track of software development).$20 

Simple Socket Library (Unix, VMS and MS-DOS; sits on TCP/IP stack).$20 

Bywater BASIC Version 1.10 (complete BASIC interpreter and interactive programming environment).$20 

Data 

Moby Thesaurus II (6,000 root words, 2.5M synonyms, ’’common sense”, concept related searches) .$500 

Moby Pronundator II (175,000 words & phrases encoded with full IPA pronunciation & emphasis points).$265 

Moby Part-of-Speech II (230,000 words and phrases described by prioritized part(s)-of-speech).$170 

Moby Hyphenator II (185,000 words fully hyphenated/syllabified).$105 

Moby Words II (610,000 words & phrases with Scrabble(tm) word list, place names, baby names, acronyms, core list for spell checkers) . . . $100 

Didionary Wora List (234,932 words in alphabetical order).$60 

Roget’s 1911 Thesaurus.$40 

U. S. Cities (names & longitude/latitude of 32,000 U.S. cities and 6,000 state boundary points).$35 

CIA World Bank II Database (13MB of maps, 5.7M vectors; coastlines, rivers, political boundaries; Africa, Asia, Europe, N. & S. America) $35 

The World Digitized (100,000 longitude/latitude of world country boundaries).$30 

CD-ROMs 

BSD/386 (POSIX-compatible O/S; complete development package, full networking, kernel debugger, X11R5, DOS box; complete source code) $900 
FontMaster II CD Library (soft fonts for HP and HP compatible laser printers, 36 different type races; 5,200 bit mapped fonts; 300MB) . . . $70 

Prime Time for Unix (Volume 2, No. 2, July, 1993; over 3.5GB of Unix C code).$60 

Wfclnut Creek Libris Britannia (over 60OMB of the best of British boards; not all source included).$55 

Linux/GNU/X by Yggdrasil Computing (lstproduction release; run from the CD; TCP/IP & NFS; drivers; MPEG; SCSI support; lots more) . $45 

Knowledge Media Multimedia (i&SMB & 13,000 files; 1,232 sounds, 179 books, 100 movies, 114 stacks, 606 programs, 214 mods) .$40 

Wilnut Creek C User’s Group (Volumes 100 to 364).$40 

InfoMagic Unix (three public domain Unfit systems: 386BSD (veision 0.1), Linux (version 0.99.10), and NetBSD).$40 

InfoMagic Source Code (Berkeley Net/2, MACH, GNU, Interviews, X, Andrew, XFree, Demacs & Winemacs, djgpp, Modula-3, etc.) . . . $40 

Walnut Creek Giga Games (more games than you imagine could exist... 3,000 files; July 93) .$35 

Knowledge Media Languages & Operating Systems (640MB of compilers, libraries, and operating systems; source code & executables) . . . $35 

Walnut Creek X11R5 and GNU (X11R5 with contributed and comp.sourcesx, over 120 GNU programs, complete C source).$35 

Walnut Creek Usenet and Simtel Unix-C (600MB).$35 

Austin Code Works Internet Whrrior #1 (PC Internet tools: Gopher, Wais, Eudora, ph, Nupop, Thimpet, TCP/IP, FAQs, drivers, docs) . . . $35 

Walnut Creek Simtel 20 MSDOS Archive (C source code but lots of other stuff too).$20 

Sprite Network Operating System (source code & documentation of Ousterhout’s Sprite O/S; Sun and DECStation boot images).$20 

The Austin Code Works Voice: (512) 258-0185 

11100 Leafwood Lane much more ... ask for catalog FAX: (512) 258-1342 

Austin, Texas 18150-3581 USA E-mail: info@acw.com 

Free surface shipping for cash in advance For delivery in Texas add 7% MasterCard/VISA 
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Listing 4 continued 


/*. 

SHARED ALLOCATE 

Allocate a block of memory to share among 
several processes. 

.*/ 

PVOID SharedAlloc(DWORD dwBytes) 

{ 

PVOID pView; 

/* Create the file mapping object. If it already */ 
/* exists, this still returns a handle to it. */ 
hFileMapping - 

CreateFi1eMapping((HANDLE)OxFFFFFFFF, 
(LPSECURITY_ATTRIBUTES)NULL, PAGE_READWRITE, 

0, dwBytes, "shared_buffer"); 

/* Map the file object into the client's address */ 
/* space and receive a pointer to the buffer. */ 
pView = MapViewOfFile(hFileMapping, 

FILE_MAP_WRITE, 0, 0, dwBytes); 

/* Make a mutex to serialize buffer operations. */ 
hmxMappedFile = CreateMutex( 
(LPSECURITY_ATTRIBUTES)NULL, 

FALSE, "buffer_mutex"); 

return(pView); 

} 


SHARED FREE 

Release a block of shared memory. 

.V 

void SharedFree(PVOID pView) 

{ 

UnmapViewOfFile(pView); 

CloseHandle(hFi 1 eMappi ng); 
CloseHandle(hmxMappedFile); 


/* End of File */ 


+ 

£ 

I 

c 
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if several processes call AddStringO concurrently, then Show- 
AllStrings() displays combined input from all the clients. 

The two exported procedures, SharedAlloc() and Shared- 
Free(), are modeled on GlobalAllocf) and GlobalFreef). 
Unlike GlobalAlloc() , however, SharedAlloc() always 
returns a pointer to the same buffer. The first call creates the 
buffer, and subsequent calls from other processes map the 
buffer into new address spaces. 

This version of SharedAlloc() creates a 1Mb memory- 
mapped file backed by the system’s paging file. One great 
benefit of using memory-mapped files is that the system’s vir¬ 
tual memory manager doesn't actually allocate any of the 
buffer until it’s needed. If the buffer fills up to the 4Kb mark, 
for example, only 4Kb is taken from physical memory, no 
matter how big the memory-mapped file is. That’s why I 
didn't bother to write a SharedReAlloc() function to enlarge 
the buffer. It's easier and more efficient to make the file very 
large from the start and let the virtual memory manager ad¬ 
just the allocation size. 

The Share DLL creates a mutex (mutual exclusion object) to 
prevent concurrent threads from corrupting the buffer con¬ 
tents and the value of dwOffset. DLLs with public data com¬ 
monly need synchronization objects to avoid concurrency 
problems. An animation library, for example, would use the 
caller’s display device context frequently. If several threads 
draw simultaneously, the actions of one might interfere with 
the others. One might select a red brush, be interrupted by a 
thread that selects a blue brush, regain control, and draw a 
blue shape by accident. In the Share DLL, AddStringO always 
waits for its mutex before consulting or modifying any global 
values. Waiting for the mutex ensures that all buffer modifica¬ 
tions occur sequentially rather than simultaneously. 

The Share library should check more often for errors; I've 
skimped for brevity. 

Conclusion 

The new features of Windows NT DLLs may at first slow 
you down as you adjust to the new system, but most of the 
changes confer clear benefits. The single entry point proce¬ 
dure is easier to manage than LibMain() and WEP(), and it’s 
also more powerful because it responds to threads as well as 
processes. With linker switches and __declspec, you can 
avoid entirely the chore of listing exports in a .def file. The 
data_seg pragma easily designates any variable public or 
private. And although you may have to cope with memory- 
mapped files and thread-local storage indexes, at least the 
system supports methods for both static and dynamic 
memory objects at all three levels of visibility — system, 
process, and thread. □ 


Listing 5 

share, def — Module definition file for 

share, c 


LIBRARY 


SECTIONS 


.Public READ WRITE SHARED 

EXPORTS 


AddStrlng 

@1 

ShowAl1 Strings 

@2 
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In Windows/DOS Developer’s Journal, vol. 4, no. 4, I answered a question from 
Raymond Wroblewski about the return value from DdeCreateDataHandle(). He 
noticed that the return value was always (Y(Yd? +31) I 32) * 32) - 4), where 
cb was the amount of space actually occupied by his data. I replied that 
DdeCreateDataHandle() relies on GlobalAlloc() for its memory allocation, and 
since GlobalAlloc() always allocates a multiple of 32 bytes, the return value should 
always be (((cb + 31) / 32) * 32) bytes long. I did not understand why he was 
seeing four bytes less than this until I read a thread in the Microsoft WINSDK forum 
on CompuServe. It turns out that when the transaction type is not XTYP_EXECUTE 
(the hszltem parameter is non-NULL), four bytes are used by DDEML for header infor¬ 
mation. Thanks to Pradeep Raj (a Microsoft developer support engineer) for uncover¬ 
ing the discrepancy. 

Q l have an interesting problem. I want to make Windows recognize a mouse 
after a startup where no mouse was detected. Is there any way to either trick 
Windows into thinking there is a mouse installed when there is not, or to build a 
small program that initializes the mouse driver and enables the mouse cursor after 
Windows is running? 

Mark Edmead 
CIS: 70323,1415 


A During Windows startup, the mouse driver (a DLL) searches for a mouse from 
the list of known types: I NT 33/)-installed mouse driver, Microsoft InPort Mouse, 
Microsoft Bus Mouse, PS/2 Mouse via ROM BIOS support, or serial mouse. If it finds 
one, it stores the type and interrupt vector in global variables and sets the 
MF_MOUSE_EXISTS bit in another global variable that contains various mouse flags. If 
Windows is running in enhanced mode, the driver also informs the Virtual Mouse 
Device (VMD) of the mouse type and interrupt vector. 


Send questions to Paul via Internet 
as paul@rdpub.cow ; 
from CompuServe: 

>INTERNET: pau l @rdpub. cow, 
or in care of this magazine at: 

1601 W. 23rd St., Suite 200 
Lawrence, KS 66046-2743. 


Paul Bonneau 


Paul Bonneau is a Software Design Engineer at a major software firm. He was a 
developer of HyperChem, a molecular modeling system marketed by Autodesk 






















If you truly need to replicate this behavior, probably the 
most straightforward approach is to modify the mouse driver 
source code supplied with the Device Driver Kit (DDK). You 
could add an extra exported routine that allows you to specify 


the mouse type and vector. The routine could store the values 
in the appropriate global variables, and inform the VMD. 

Creating a customized mouse driver is unnecessary, how¬ 
ever, if all you want to do is manipulate the mouse cursor. 
USER ( user.exe) is the Windows module that handles this 


Listing 1 mousedmo.c - Demonstrating enabling the mouse 

j*****************************************************j 


t* mousedmo.c */ 

if (hinsPrev *■ NULL) 

/* -- Program demonstrates enabling the mouse when */ 

( 

/* no mouse is physically present. */ 

/* -- To build: “cc -DSTRICT mousedmo.c" */ 

WNDCLASS wcs; 

^************* ****************************************j 

wcs.style = 0; 

wcs.lpfnWndProc = LwWndProc; 

finclude <windows.h> 

wcs.cbClsExtra = 0; 
wcs.cbWndExtra = 0; 

LRESULT CALLBACK export LwWndProc(HWND hwnd, UINT wm, 

wcs.hlnstance = hins; 

WPARAM wParam, LPARAM IParam); 

wcs.hlcon = LoadIcon(NULL, IDIAPPLICATION); 
wcs.hCursor = LoadCursor(NULL, IDC ARROW); 

char szMouseClass[] = "Moused ass"; 

wcs.hbrBackground = (HBRUSH)(COLOR WINDOW + 1); 

int dxScreen, dyScreen; 

wcs.lpszMenuName = NULL; 

int dxMouse, dyMouse; 

wcs.lpszClassName = szMouseClass; 
if (!RegisterClass(&wcs)) 

Idefine wGrid 20 

return FALSE; 

int PASCAL WinMain(HINSTANCE hins, HINSTANCE hinsPrev, 

J 

LPSTR IpszCmd, int wShow) 

msg.wParam = 0; 

J*****************************************************j 

dxScreen » GetSystemMetrics(SM CXSCREEN); 

1* -- Entry point. */ 

dyScreen - GetSystemMetrics(SM CYSCREEN); 

^*****************************************************J 

dxMouse = dxScreen / wGrid; 

( 

dyMouse = dyScreen / wGrid; 

MSG msg; 

if (IGetSystemMetrics(SM MOUSEPRESENT)) 

HWND hwnd; 

ShowCursor(TRUE); 
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kind of user interface functionality. There is a signed in¬ 
teger global variable inside USER’S DGROUP that contains the 
ShowCursor() count (it is at offset 0x00e8 in the debugging 
version of Windows 3.1). For the sake of readability, I will refer to 
this global variable as wShowCount. wShowCount is incremented 


Listing 1 continued 


if ((hwnd = CreateWindow(szMouseClass, 

"Mouse Demo", WS_OVERLAPPEDWINDOW, CWJJSEDEFAULT, 
CWJJSEDEFAULT, CWJJSEDEFAULT, CWJJSEDEFAULT, 

NULL, NULL, bins, NULL)) != NULL) 

( 

ShowWindow(hwnd, wShow); 

while (GetMessage(&msg, NULL, 0, 0)) 

{ 

TranslateMessage(&msg); 

DispatchMessage(&msg); 

} 

} 

if (!GetSystemMetrics(SM_MOU$EPRESENT)) 
while (ShowCursor(FALSE) >= 0) 


return msg.wParam; 

} 

LRESULT CALLBACK _export 

LwWndProc(HWND hwnd, UINT wm, WPARAM wParam, 

LPARAM IParam) 

^***************************************************** j 

/* -- Main window procedure. */ 

^*****************************************************j 

( 

switch (wm) 

( 

default: 

break; 

case WM_DESTR0Y: 

PostQuitMessage(O); 
break; 

case WMJJSER: 

ShowCursor(TRUE); 
break; 

case WM_KEYD0WN: 

( 

POINT pt; 

GetCursorPos(&pt); 
switch (wParam) 

{ 

default: 

goto LCallDef; 

case VK_LEFT: 

pt.x -= dxMouse; 
break; 

case VK_RIGHT: 

pt.x += dxMouse; 
break; 

case VK_UP: 

pt.y -= dyMouse; 
break; 

case VK_D0WN: 

pt.y += dyMouse; 
break; 

) // End switch wParam. 
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Listing 1 continued 


pt.x = (pt.x + dxScreen) % dxScreen; 
pt.y ■ (pt.y + dyScreen) % dyScreen; 
SetCursorPos(pt.x, pt.y); 

1 

return 0; // End case WM_KEYD0WN. 

) // End switch wm. 

LCallDef: 

return DefWindowProc(hwnd, wm, wParam, IParam); 
1 

/* End of File */ 


each time ShowCursor(TRUE) is called (to display the cursor) 
and decremented each time ShowCursor(FALSE) is called (to 
hide the cursor). If its value is 0 or greater, Windows keeps 
the cursor visible, else it hides the cursor. The intent is that 
showing and hiding the cursor should be done in pairs. 

Later on in the Windows startup sequence, USER initializa¬ 
tion code calls the mouse driver's Inquire() exported func¬ 
tion to determine if a mouse is present If the mouse driver 
returns a value that indicates no mouse is present, wShowCount is 
set to -1, otherwise, it is left unchanged at 0 (it was set to zero 
when USER'S DGROUP was created). The result is that if no 
mouse is detected, Windows will not display a cursor; other¬ 
wise, it will. 

This is good news. It means that to display the cursor 
when no mouse is present, an application has only to call 
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ShowCursor(TRUE). mousedmo.c (Listing 1) implements a small 
demonstration program that shows the cursor at startup and 
removes it at shutdown. It also moves the cursor in response 
to a press of any of the four arrow keys. 

WinMain() passes the SM_MOUSEPRESENT value to 
GetSystemMetrics () to determine if a mouse is physically 
present. In my first version of this program, if no mouse was 
present, I called ShowCursor (TRUE) at the start of UinMain() 
and ShowCursor (FALSE) at the end. But when I removed my 
mouse (I have an InPort mouse, so it was necessary to 
remove the card as well) and ran mousedmo.exe, the cursor 
was left on the screen after the program terminated. I used 
the debugger to verify that mousedmo.exe was calling a 
matching pair of ShowCursor ()s. So why was the cursor not 
hidden when the program terminated? 

It turns out that Program Manager is the culprit. When it 
launches a program, it sets the cursor shape to the hourglass 
(via the SetCursor() call). In order to ensure that the cursor 
is actually visible, it too checks if a mouse is present, using 
GetSystemMetrics (SMJLOUSEPRESENT), and shows the cursor 
if there is no mouse. But the code on the other side of the 
launch (paraphrased into C) is not symmetric: 

if (IGetSystemMetrics( 

SM_MOUSEPRESENT)) 

{ 

int wShow; 

wShow = ShowCursor(FALSE); 

wShow++; 

if (wShow != 0) 

ShowCursor(TRUE); 

} 


ShowCursor() returns the new value of wShowCount. So after 
Program Manager hides the cursor (if no mouse is present), it 
then checks to see if the cursor was just hidden. If the cursor 
just went from visible to hidden, the value returned from the 
first ShowCursor will be -1. Adding 1 makes the value 0. 

If the new value is not 0, then the transition did not occur, 
so the code has a change of heart, and decides to reshow the 
cursor! I think this bizarre logic is really a bug. What was 
probably the rationale is that if the cursor was already in¬ 
visible, there is no need to make it more so. Assuming that 
the code was originally written in C, the bug is probably a 
result of using an unsigned value for wShow, or a “!=" com¬ 
parison when a “<” was required. 

Program Manager uses WinExecO to launch applications. 
WinExec() does not return until the launched program either 
terminates or yields by calling one of the message functions 
or Yield(). So when the code on the far side of program 
manager's call to UinExec() runs, the value returned from the 
first call to ShowCursor() is 0. After incrementing this value, 
the condition to execute the second ShowCursor() was met. 
As a result, Program Manager had called ShowCursor (TRUE) 
twice and ShowCursor (FALSE) once. Since my WinMain() ex¬ 
ecutes a balanced pair of ShowCursor() calls, the cursor 
remains visible after the mouse demo program terminates. 

I added code to the final version of WinMainO to 
counteract Program Manager. If no mouse is present, then just 
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before UinMain() terminates, it calls 
ShowCursor(FALSE) in a loop, until the 
return value is negative. This guaran¬ 
tees the cursor will not be visible. 

Another approach to this problem 
would be to wait until control had been 
returned back to Program Manager 
before showing the cursor. The problem 
with this approach is that it’s difficult to 
determine whether Program Manager 
has regained control and executed its 
code on the far side of the call to 
UinExec(). Posting a message to 
mousedmo.exe' s main window and then 
showing the cursor when the message 
is received will not work, since the Win¬ 
dows scheduler will allow the currently running task to empty 
its local queue before yielding. You may be able to use an 
explicit call to Yield() —or even DirectedYieldf) —just after 
the main window is created in WinMain() to force Program 
Manager to regain control before showing the cursor. 



LRESULT CALLBACK _export LEilterInts(HWND hwnd, 

HINT message, WPARAM wParam, LPARAM IParam) 


short n = GetWindowWord(hwnd, GWW_ID) - IDC_EDITXSIZE; 

if (message == WM_KEYDOWN || message == WM_CHAR 
|| message == WM_KEYUP) { 
if((wParam > (WORD)'9 1 )) { 

if(message == WM_CHAR) // don't beep for 1 a'-'i 1 when using numpad 
MessageBeep(MB_ICONASTERISK); 
return 0; 

} 

} 

return CallWindowProc(lpfnEdit[n], hwnd, message, wParam, IParam); 


eE3: 


Borland C++ v3.1 
Microsoft C/C++ v7.0a 
Visual C++ v 1.0 


Q 


Validation of user input has got to be one of the most 
common tasks of Windows programming. I needed to 


get user input of two sizes, with a maximum of four digits. 
The way I finally solved it was by subclassing the two edit 
controls, saving their old window procedure addresses in 
IpfnEdit[], and sending them to LFilterlnts(). I limited 
text length by sending an EM_LIMITTEXT message. The con¬ 
trols are consecutively numbered, starting with 
IDC_EDITXSIZE (see Figure 1). 

I beep only on UM_CHAR messages since the WM_KEYDOUN 
and WM_KEYUP messages for VK_NUMPADx collide with the let¬ 
ters a through i. Although I managed to reduce the complexity 
of the procedure pretty much, I’m not really satisfied. I’m not 
a very experienced Windows programmer and it feels like 
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Listing 2 editval.c - Sample edit field validation dialog 


j*****************************************************j 

/* editval.c */ 

/* -- Sample edit field validation dialog. */ 

/* -- To build: “cc -DSTRICT editval.c editval.rc“ */ 

j ***************************************************** j 

ifinclude <windows.h> 
linclude "editval,h" 

case WM_COMMAND: 
switch (wParam) 

f 

default: 

break; 

case IDOK: /» Parse edit fields. */ 

fdefine cw 2 /* Number of edit fields. */ 

i 

EFV efv; 

typedef struct 
/ 

if (FParseEditsEfv(&efv, hwnd)) 

/ 

UINT rgw[cw]; 

} EFV; /* Edit field values. */ 

1 

‘lpefv = efv; 

EndDialog(hwnd, TRUE); 
return TRUE; 

struct /* Edit Field Limits. *1 

) 

l 

i 

UINT wMin, wMax; 

} rgefl [] = 

1 

/ 

break; 

case IDCANCEL: 

{ 1000, 2000 }, 

{ 2000, 3000 } 

}; 

EndDialog(hwnd, FALSE); 
return TRUE; 

) /* End switch wParam. */ 

break; /* End case WM COMMAND. */ 

BOOL CALLBACK _export FD1 gProc(HWND hwnd, UINT wm, 

WPARAM wParam, LPARAM IParam); 

BOOL FParseEditsEfv(EFV * pefv, HWND hwnd); 

) /* End switch wm. */ 

return FALSE; 

) 

#ifdef _BORLANDC_ 

# pragma argsused 
#endif 

int PASCAL WinMain(HINSTANCE hins, HINSTANCE hinsPrev, 

LPSTR IpszCmd, int wShow) 

< 

BOOL 

FParseEditsEfv(EFV * pefv, HWND hwnd) 
^*****************************************************^ 

/* — Parse the dialog's edits and return in ‘pefv. */ 

/* -- pefv : Return parsed edit field values here. */ 

EFV efv; /* Initial and final values. */ 

char sz[128]; 

/* -- hwnd : Dialog window. */ 

J ***************************************************** j 
/ 

efv.rgw[0] = efv.rgw[l] = 0; 

DialogBoxParam(hins, 

MAKEINTRESOURCE(dlgEditVal), NULL, FDlgProc, 

(LONG)(EFV far *)&efv); 
wsprintf(sz, "Edit 1 = %d, Edit 2 « %d“, 
efv.rgw[0], efv.rgw[l]); 

MessageBox(NULL, sz, "Final values", MB OK); 
return 0; 

int iw; 

for (iw = 0; iw < cw; iw++) 

{ 

BOOL fOk; 

UINT did = iw + didEditl; 

pefv->rgw[iw] = 

} 

BOOL CALLBACK export 

FDlgProc(HWND hwnd, UINT wm, WPARAM wParam, 

LPARAM IParam) 

^*****************************************************^ 

/* -- Dialog procedure. */ 

j*****************************************************J 

GetDlgItemInt(hwnd, did, &f0k, FALSE); 
if (!fOk || pefv->rgw[iw] < rgefl [iw] .wMin || 
pefv->rgw[iw] > rgefl [iw] .wMax) 

{ 

char sz[128]; 

/* Invalid field, inform user, and put */ 

/* focus back on field. */ 

( 

static EFV far * lpefv; 

GetDlgItemText(hwnd, did, sz, sizeof sz); 
wsprintf(sz + lstrlen(sz), " is invalid. 11 
"Please enter a number from %d to %d". 

switch (wm) 

{ 

rgefl [iw] .wMin, rgefl [iw] .wMax); 

MessageBox(hwnd, sz, "Sample Dialog", 

default: 

break; 

MB_0K); 

SetFocus(GetDlgItem(hwnd, did)); 
return FALSE; 

case WM INITDIALOG: 

} 

{ 

int iw; 

) 

return TRUE; /* All fields are valid. */ 

/* Remember where to return values. */ 
lpefv = (EFV far *)lParam; 

/ 

/* End of File */ 

/* Initialize edit fields. */ 
for (iw =0; iw < cw; iw++) 

SetDlgItemInt(hwnd, didEditl + iw, 
lpefv->rgw[iw], FALSE); 

i 


1 

return TRUE; 
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there should be a better way to solve such a common prob¬ 
lem as this. 

That is my first question, the second is: in a procedure like 
this, is it correct to return OL when I just want to discard the 
message? 

My third question is: I have a program that simply consists 
of a dialog box. I used SetClassWord() to set an icon to show 
up when Alt-Tabbing between applications. Do I need to reset 
the handle to the original icon before terminating the applica¬ 
tion? If I fail to do so with the above-mentioned window pro¬ 
cedure, the result is a GPF. 

Thanks for a very informative 
magazine. 

Ola Strand berg 
Ottars v. 1B 
S-754 40 Uppsala 
SWEDEN 


with the OK button). If a field value is invalid, the user is in¬ 
formed of the valid values, usually by means of a message 
box, and the dialog is not dismissed. If all the edit fields are 
valid, the dialog is dismissed. 

The advantage of the first approach is that it can be ac¬ 
complished in a relatively small amount of code. The ad¬ 
vantages of the second approach are that much more explicit 
validation can be performed (e.g., all integers between 1,000 
and 2,000), and that intermediate invalid fields are ignored 
(e.g., if the user hit the space bar to clear the contents of a 
fully selected edit field). 

A disadvantage of the first approach is that it doesn’t give 
the user much feedback. For example, a user trying to enter a 


Internet: olas@Minsk.DoCS.UU.SE 

A There are two main approaches to 
validating edit fields. The first 
method, the one you have imple¬ 
mented, is to force each keystroke into 
the accepted range. The second is to 
allow the user to fill all the edit fields of 
the dialog with values, then validate 
each field after the values have been 
obtained by the dialog procedure 
(usually when the dialog is dismissed 
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Listing 3 editval.rc — Resource definitions for 
validation dialog 


^*****************************************************^ 
/* editval.rc */ 

/* -- Dialog resource for sample edit field */ 

/* validation dialog. */ 

^************★★**★★**★★*****★*★****★★******★***★*★★**★j 

linclude <windows.h> 

#include "editval.h" 


dlgEditVal DIALOG 6, 18, 82, 56 
STYLE DS_MODALFRAME | WS_P0PUP | WS_VISIBLE | 
WS_CAPTION | WS_SYSMENU 
CAPTION "Sample Dialog" 

FONT 8, "MS Sans Serif" 


BEGIN 

LTEXT 

EDITTEXT 

LTEXT 

EDITTEXT 

DEFPUSHBUTTON 

END 


"Edit &1:“, -1, 2, 4, 26, 8 
didEditl, 34, 2, 46, 12, 
ES_AUT0HSCR0LL 

"Edit 8.2:“, -1, 2, 20, 26, 8 
didEdit2, 34, 18, 46, 12, 
ES_AUT0HSCR0LL 
"Push", IDOK, 2, 40, 78, 14 


negative number would just get beeped at each time she 
pressed the key. A message explaining the permissible 
range would be much more helpful. A disadvantage of the 
second approach is that you have to write a lot more code. If 
you group all the edit values for a dialog into a struct, you 
will probably need two instances of the struct. One instance 
will contain the values returned by the dialog when it is suc- 
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cessfully dismissed; the other is needed to hold edit values as 
they are parsed. 

To understand the need for two copies of the same struc¬ 
ture, consider the following scenario. Suppose you use only 
one structure. The user hits the OK button with invalid edit 
fields. The dialog procedure displays a message box to warn 
the user of the invalid field. After dismissing the message box, 
the user decides not to mess with this particular dialog, and 
hits the Cancel button. The problem is that the fields preced¬ 
ing the invalid one have now been replaced with whatever 
values the user entered. But the Cancel button means restore 
the original values of the dialog, which is now impossible. By 
using two instances of the structure, the structure returned by 
the dialog procedure is not touched unless the user has hit 
the OK button with all edit fields valid. 

A variant of the second approach validates edit fields when 
they lose the focus (an edit control sends its parent an 
EN_KI LLF0CUS notification via the WM_COMMAND message when 
it loses the focus). This technique works well when the dialog 
is used as a data entry form. Unfortunately, it is very difficult 
to get right. The potential problems are best illustrated with 
an example. Consider a dialog that contains two edit fields. 
Assume the second edit field follows the first in the tab order. 
The dialog procedure has been constructed to validate each 
edit field when it loses the focus. If an edit field is invalid, the 
procedure calls MessogeBox() to inform the user of the error. 
After the user dismisses the message box, the focus returns to 
the invalid field. The dialog is now visible, the focus is on the 
first edit field, and both edit fields are initially empty. 

At this point, if the user hits Tab, two message boxes 
will be displayed, one for each edit field! The reason is that 
when the user hits the Tab key, IsDialogMessage() calls 
SetFocus() to set the focus to the second edit field. 
Set Focus () sends a UM_KILLF0CUS to the first edit field, which 
in turn sends a UM_C0MMAND message with an EN_KILLF0CUS 
notification to the dialog procedure. The dialog procedure sees 
that the first edit field is empty, and therefore invalid, and 
calls MessageBox() to inform the user. But MessageBox() gives 
its OK button the focus during initialization. This causes a 
WM_KILLF0CUS message to be sent to the second edit field, 
since the window manager now believes that the second edit 
field has the focus. In response, the second edit field sends a 
WM_C0MMAND with an EN_KILLF0CUS notification to the dialog 
procedure. The dialog procedure sees that the second edit 
field is empty, and therefore also invalid, and so calls 
MessageBox() again. 

Using a mouse makes the situation even worse. Referring 
to the above example again, suppose the user presses the OK 
button with the mouse. In this case the OK button will be 
permanently depressed, even though it doesn't have the focus 
(the focus was “stolen" by the message box). At this point, if 
the user presses the OK button again, the button will pop out 
and the message box will reappear (since the first edit control 
will still have the focus). After the user dismisses the message 
box, the OK button will revert to being depressed. (This be¬ 
havior is, at best, extremely confusing for the user. I en¬ 
counter problems like this far too often in commercial 
software products.) 
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You can work around these problems, but you will end up 
with incredibly fragile code —specifically, code that is completely 
dependent on the tab order of the controls in the dialog 
template. The code will be hard to maintain, and even harder 
to debug. You may be wondering how some of the large 
Microsoft applications manage to implement edit field valida¬ 
tion when the focus changes. The answer is simple: these ap¬ 
plications do not use the dialog manager built into Windows, 
but roll their own instead (in fact, most of the controls in 
these dialogs do not even possess windows). 

My preference for a simple dialog such as yours would be 
to perform validation all at once. As I mentioned earlier, the 
validation would typically occur in response to a press of the 
OK button. However, the same approach can be used for 
modeless dialogs, where pushing a button causes some action 
to be taken other than dismissing the dialog (an example is a 
find/replace dialog box). Each time the action push button is 
pressed, the edit fields can be validated. If they are valid, the 
action is taken; else, the user is notified the fields are invalid. 

editval.c (Listing 2) contains a program to demonstrate a 
dialog that uses the validate-all-at-once approach, editval.rc 
(Listing 3) is the resource file that defines a dialog box, and 
editval.h (Listing 4) defines the constants used in the dialog. 
The program displays the dialog box, which consists of two 
edit fields (with labels) and a pushbutton. After the user dis¬ 
misses the dialog, the program displays the final edit field 
values in a message box. Each edit field holds an unsigned 
integer. The limits for each are contained in the array rgefl. 
Each member of the array is a structure containing a pair of 
unsigned integers for the low and high limits. I defined the 
range of the first edit field to be [1000, 2000], and the second 
edit field to be [2000, 3000], 

The structure type EFV holds the values of the edit fields. 
UinMain() declares a local EFV, initializes its members to 0, 
and passes its address to the dialog via DialogBoxParam(). 
The dialog box procedure, FDlgProc(), obtains the EFV ad¬ 
dress from the IParam of the WM_INITDIAL0G message and 
stores it in a static variable (Ipefv), since the referenced EFV 
needs to be updated if the dialog is successfully dismissed. If 
you want to have more than one instance of the dialog 
present at one time, store the pointer (or actual values) with 
the dialog's window. A convenient and fast way to accomplish 
this is with GetPropO and SetProp(). 

The UM_INITDIALOG message code also sets the contents of 
the edit fields to the initial values of *lpefv. When the dialog 
procedure receives a WM_COMMAND message from the OK push¬ 
button, it calls the helper routine FParseEditsEfv() to parse 
and validate the contents of the edit fields. If all goes well, the 
contents of an EFV referenced by the pefv parameter are 
filled and the routine returns true. FDlgProc() passes the ad¬ 
dress of a local EFV to FParseEditsEfv(). If the routine suc¬ 
ceeds, the contents of the local EFV are copied to the EFV 
referenced by the static pointer, and EndDialogO is called to 
dismiss the dialog. 

I hope this answers your first question. As for your second 
question, returning 0 instead of calling the edit control's 
original window procedure is acceptable for the three mes¬ 
sages you are trapping; \VM_KEYD0\YN, m_KEYUP, and m_CHAR. 
This is not true for the general case, however. Even if you 


Listing 4 editval.h — Dialog constants for editval.c 


I*************************************************★*★★j 

/* editval.h */ 

/* -- Dialog constants for sample edit field */ 

/* validation dialog. */ 

f*****************************************************J 

♦define dlgEditVal 1000 /* Dialog id. */ 

♦define didEditl 1001 /* First edit field id. */ 
♦define didEditZ 1002 /* Second edit field id. */ 

/* End of File */ 


don’t want the edit control’s original window procedure to see 
a particular message, it may be necessary to at least supply 
the message to DefWindowProc(). For example, the 
UM_MOUSEACTIVATE message is passed up the chain of child 
windows until it is received by a top-level or popup window. 
DefUindowProc() is responsible for walking up the chain, so it 
should be called instead of just returning 0. 

The short answer to your last question is no — failing to 
reset the class icon for the dialog box class should not result 
in a UAE when the application is terminated. A more likely 
culprit here is forgetting to export your dialog box procedure. 
There are two ways of accomplishing this: you can declare 

your Windows callback with the_ export keyword, or you 

can call MakeProcInstance() to create an “instance thunk" to 
be supplied to Windows (in this case via the dlgprc field of 
DialogBox()), and list the name of the callback in the 
EXPORTS section of the module definition file. 1 recommend 
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Listing 5 dlgicon.c — Demonstrating per-dialog icons 


!*****************************************************j 


/* dlgicon.c */ 

/* Get the dialog template. */ 

/* — Demonstrate per-dialog icons. */ 

if ((hrsrc = FindResource(hins, lpszDlt, 

/* -- To build: "cc -DSTRICT dlgicon.c dlgicon.rc" */ 

RT DIALOG)) == NULL | | 

j*****************************************************/ 

(hgbl = LoadResource(hins, hrsrc)) == NULL || 

linclude <windows.h> 

(lpdlt = LockResource(hgbl)) == NULL) 

linclude <windowsx.h> 
linclude <toolhelp.h> 

goto LCleanup; 

linclude <string.h> 

/* Find class name member. */ 

bClass = (lpdlt->szMenuName[0] == Oxff ? 

typedef struct 

3 : lstrlen(lpdlt->szMenuName) + 1); 

{ 

DWORD ulwStyle; 

1pszClass = lpdlt->szMenuName + bClass; 

BYTE citm; 

/* Resize dialog template resource if necessary */ 

unsigned short x, y, dx, dy; 

/* to hold new class name. */ 

char szMenuName[l]; 

cbClassOld = 1strlen(lpszClass) + 1; 

} DLT; /* DiaLog Template. */ 

cbClassNew = Istrlen(pszClass) + 1; 
cbOld = (int)GlobalSize(hgbl); 

BOOL CALLBACK export FDlgProc(HWND hwnd, UINT wm, 

if (cbClassNew > cbClassOld) 

WPARAM wParam, LPARAM IParam); 

{ 

HGLOBAL HgblSetDlgIcon(LPCSTR lpszDlt, char * pszClass, 

UnlockResource(hgbl); 

HICON hicn, HINSTANCE bins); 

lpdlt = NULL; 

if ((hgblNew = GlobalReAlloc(hgbl, cbOld + 

lifdef BORLANDC 

cbClassNew - cbClassOld, GMEM MOVEABLE)) == 

Ipragma argsused 

NULL) 

#endif 

goto LCleanup; 

int PASCAL WinMain(HINSTANCE bins, HINSTANCE hinsPrev, 

hgbl = hgblNew; 

LPSTR IpszCmd, int wShow) 

if ((lpdlt = LockResource(hgbl)) == NULL) 

( 

goto LCleanup; 

HGLOBAL hgbl; 

IpszClass = lpdlt->szMenuName + bClass; 

HICON hicn; 

char szClass[MAX_CLASSNAME]; 

} 

/* Make room for new class name. */ 

szClass[0] = 0; 

fmemmove(IpszClass + cbClassNew, 

if ((hicn = LoadIcon(NULL, IDI QUESTION)) != NULL) 

IpszClass + cbClassOld, cbOld - 

{ 

if ((hgbl = HgblSetDlgIcon("MyDialog", szClass, 

(IpszClass - (char far *)lpdlt) - cbClassOld); 

hicn, hi ns)) != NULL) 

/* Copy new class name into dialog template */ 

{ 

/* resource. */ 

DialogBoxIndirect(hins, hgbl, NULL, 

lstrcpy(lpszClass, pszClass); 

FDlgProc); 

FreeResource(hgbl); 

fOk = TRUE; 

} 

LCleanup: 

if (szClass[0] != 0) 

if (lpdlt != NULL) 

UnregisterClass(szClass, hins); 

UnlockResource(hgbl); 

} 

if (!fOk && hgbl != NULL) 

/ 

return 0; 

1 

FreeResource(hgbl); 

} 

HGLOBAL 

hgbl = NULL; 

} 

HgblSetDlgIcon(LPCSTR lpszDlt, char * pszClass, 

return hgbl; 

HICON hicn, HINSTANCE hins) 

^*****************************************************^ 

} 

/* -- Create a new private dialog class with given */ 

#ifdef BORLANDC 

/* icon. Load the dialog template, and change */ 

Ipragma argsused 

/* its class to the new name. Return the */ 

lendif 

/* modified dialog template and new class name. */ 

BOOL CALLBACK export 

!***************************************************** j 

FDlgProc(HWND hwnd, UINT wm, WPARAM wParam, LPARAM IParam) 

{ 

switch (wm) 

i 

WNDCLASS wcs; /* Cloned class. */ 

HRSRC hrsrc; /* Dialog template resource. */ 

{ 

HGLOBAL hgblNew; /* New dialog template. */ 

default: 

HGLOBAL hgbl = NULL; /* Old template. */ 

int fOk = FALSE; 

break; 

DLT far * lpdlt; /* New template pointer. */ 

case WM INITDIALOG: 

char far * 1pszClass; /* Unique class name. */ 

UINT bClass; /* Offset to class name. */ 

return TRUE; 

int cbClassOld, cbClassNew, cbOld; 

case WM COMMAND: 

static long cact; /* Number of times called. */ 

if (wParam == IDOK || wParam == IDCANCEL) 

/ 

/* Get the dialog class and clone it. */ 

i 

EndDialog(hwnd, TRUE); 

GetClassInfo(NULL, MAKEINTRES0URCE(32770), &wcs); 

return TRUE; 

wsprintf(pszClass, "MyDialog%lx", ++cact); 

} 

wcs.lpszClassName = pszClass; 

break; /* End case WM_COMMAND. */ 

wcs.lpszMenuName = NULL; 
wcs.hlcon = hicn; 

} /* End switch wm. */ 

wcs.hlnstance = hins; 

return FALSE; 

} 

/* End of File */ 

/* Register the cloned class. */ 
if (!RegisterClass(&wcs)) 

{ 

pszClass[0] = 0; 
return NULL; 

} 
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the first way, since it relieves you of responsibility for keeping 
track of instance thunks in your code. I should point out that 
even though failure to reset the class icon may not be fatal, it 
is a rather impolite thing to do. SetClassUord() changes the 
attributes of the actual class, not just the one window whose 
handle is passed to the routine. This is confusing, since passing 
a window handle seems to imply that only that window is 
affected. In reality, you could pass the window handle of any 
dialog and produce exactly the same result. While the new 
icon handle is in the class, all current and subsequently 
created dialogs will use this icon handle, whether they are 
created by your application or another one. 

Another problem with not resetting the class icon arises if 
the icon you install is one of your resources. In this case, the 
icon handle will no longer be valid after your application ter¬ 
minates (Windows cleans up a task’s dangling resources). If 
the icon for a subsequent dialog is drawn, the icon handle will 
be invalid, and the result will be a black square. This is not a 
catastrophe, since it only affects applications possessing 
dialogs with a NULL owner or dialogs that use a minimize but¬ 
ton, and it results in an RIP, not a UAE (RIPs only occur with 
the debugging version of Windows and are generated when, 
among other things, the system detects an invalid parameter). 
Nevertheless, it is not good programming practice, and should 
be avoided. 

The essential problem with a window’s icon is that the 
icon really doesn’t belong to the window. Instead, the icon 
handle is a property of the class. But changing the class icon 
also creates complications. Fortunately, you can use the 
simple trick of cloning a new class for dialogs that need to 
possess their own icon, creating the dialog with the cloned 
class, and removing the class after the dialog terminates. Even 
though none of the eight dialog box creation routines allows 
you to explicitly specify a class name, there is a provision for a 
class name inside a dialog template resource. The code for 
dlgicon.c (Listing 5) exploits this trick. 

This demonstration program creates a dialog possessing 
only an OK button. The dialog’s resource file, in Listing 6, uses 
the NS_MINIMIZEBOX style, but not the DS_MODALFRAME style, 
so that the dialog can be minimized. USER not only draws the 
class icon when a user switches between applications with 
Alt-Tab, but also (via DefUindowProc()) when a window is 
minimized. You cannot use both NS_MINIMIZEBOX and 
DS_MODALFRAME, since USER will become confused and incor¬ 
rectly position the minimize icon (especially when it is in the 
"pushed in” state). 

dlgicon.c declares a structure type that corresponds to 
the first few fields of the pseudo-structure for a dialog 
template outlined in the SDK documentation (see page 90 of 
Programmer’s Reference, Volume 4: Resources). This is not a 
true C struct because there are several zero-length array 
members. My structure’s only purpose is to help locate the 
embedded class name string, which immediately follows the 
embedded menu name string. 

NinMainf) first loads an icon for the dialog (because I am 
lazy, I just grabbed one of the built-in system icons). It then 
calls the helper routine HgblSetDlgIcon() to return a dialog 
template resource handle containing a new class name. 
HgblSetDlgIcon() also registers the new class, and returns 


the class name via the pszClass parameter. If the routine suc¬ 
ceeds, DialogBoxIndirect() is called to display the dialog. 
The dialog behaves in every way like a normal dialog, except 
that it displays its own icon. After the dialog terminates, the 
dialog template resource is freed, and the class is un¬ 
registered. Unregistering the class is a simple piece of hygiene 
that helps keep the primary USER local heap free. Each class 
occupies 40 bytes of this heap. 

HgblSetDlgIcon() does all the dirty work. Its first chore is 
to clone the standard dialog window class. Unfortunately, this 
class masquerades under the name "#32770” (it can also be 
referenced using MAKEINTRESOURCE(32770)). The SDK does not 
document this, but references to it can be found in the 
knowledge base on the MSDN CD 4 under topic Q88167 in the 
“Visual Basic for Windows" section and topic Q72918 in the 
"Microsoft Access” section. Both of these specify “#32770” as 
the class for both setup.exe's and winver.exe’ s main win¬ 
dows. It is no surprise that both of these applications use a 
dialog as their main window. What is surprising is that while 
winver.exe is a benign little application that doesn’t set an 
icon for itself, setup.exe does. Furthermore, setup.exe ham¬ 
mers the dialog class icon, and does not even bother to reset 
it. So if you run winver.exe, Alt-Tab back to Program 
Manager, run setup.exe, then exit setup.exe, all further Alt- 
Tabs to winver.exe will cause Windows to RIP! 1 could under¬ 
stand this if setup.exe were used only to install Windows, 
but it performs other tasks, such as changing video drivers 
after Windows has already been installed. 
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Listing 6 Dialog resource for per-dialog icons 


I *****************************************************/ 

/* dlgicon.rc */ 

/* -- Dialog resource for per-dialog icons demo. */ 

(include <windows.h> 

MyDialog DIALOG 6, 18, 100, 18 

STYLE WS_P0PUP | WS VISIBLE | WS_CAPTI0N | WS_SYSHENU | 
ws_mTnimizebox ” 

CAPTION “Dialog With Icon" 

FONT 8, "MS Sans Serif" 

BEGIN 

DEFPUSHBUTTON "Push", IDOK, 2, 2, 96, 14 
END 


After obtaining the dialog class using GetClassInfo(), 
HgblSetDlglcon() attempts to create a unique name for a 
new class. Since it does not set the CS_GLOBAL class bit of the 
UNDCLASS's style member, and therefore registers a task- 
specific class, the name need only be unique for the current 
task. I chose simply to concatenate the string "MyDialog" 
with a long integer, and increment the integer each time 
HgblSetDlglcon() is called. The new icon handle is placed in 
the class structure, and the menu name field is reset to NULL, 
since GetClassInfo() leaves the member uninitialized. 

After registering the cloned class, HgblSetDlgIcon() locates 
the dialog template resource, obtains the global handle, and locks 
it down. Even though the handle returned by LoadResource() is 


nothing more than a global handle, it is important to use 
LockResourcef) instead of calling GlobalLock() to obtain a 
far pointer. The reason is that resource segments are discar¬ 
dable: GlobalLock() will return NULL if you ask it to lock a 
discarded segment, whereas LockResource() will attempt to 
reload the segment. 

HgblSetDlglcon() now looks for the location of the class 
name within the dialog template. The code is a little arcane 
since the preceding embedded menu name string may have 
one of three forms. The first is a lone NULL, which means use 
the default class-, the second form has Oxff in the first byte, 
followed by a short which specifies the ordinal number of a 
menu resource-, and the third is an embedded zero-terminated 
ASCII string specifying a menu resource name. 

The next chunk of code calculates the size of the old and 
new class names, and reallocates the dialog template seg¬ 
ment if the new name is larger than the old. The C runtime 
library function _fmemmove() is used to size the “hole” for the 
new class name inside the template. The new class name is 
then copied into the hole, and the function returns a global 
handle to the modified template. 

This approach is quite different from the one proposed by 
Joseph M. Newcomer in “Modeless Dialog Boxes for Windows" 
(Dr. Dobb’s Journal, May 1993). In his article, Dr. Newcomer sets 
the icon handle in the dialog class to NULL and intercepts 
various messages to draw the icon himself. Unfortunately, the 
code does not handle the Alt-Tab case, and it permanently 
alters the dialog class icon for all future dialogs. □ 
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Ron Burk 


WUIMAN Object Definition 

Ron Burk 


This is the third in a series of columns about the design and implementation of 
WUIMAN (the Windows User Interface MANager). The first column described the basic 
design of WUIMAN as a hierarchical tree of objects, each of which corresponds to a 
user interface element such as a window or menu. The hierarchical tree can also be 
viewed as a database; it provides persistence, so that as the programmer or user 
interactively makes changes to the user interface, the corresponding changes in the 
WUIMAN database are remembered across invocations. Last month’s column 
provided a generic list class and a file I/O class that will be useful in building the 
database. This column tackles AUuiObject, the class whose objects actually make up 
the WUIMAN database, and whose characteristics define much of the behavior of 
WUIMAN to programmers. 

References, Creating, and Cloning 

I toyed for a long time with incorporating the concept of references into the 
WUIMAN database. For example, suppose your application had two different win¬ 
dows that used exactly the same menu. WUIMAN certainly shouldn't make you 
create the same menu from scratch for each window. What if WUIMAN let you 
create the menu once, and then store a reference to it (instead of the actual menu 
itself) in each window? Then, although the WUIMAN database might appear to con¬ 
tain two identical menus under two different windows, behind the scenes they 
would really be the same menu. Therefore, changes in the menu of one window 
would automatically affect the other. 

I finally rejected the idea of references because of the increase in complexity, 
both for the user and for the implementation of the WUIMAN database. For the user, 
references could violate the principle of least surprise. Take the example of a menu 
referenced by two different windows. I plan to create a WUIMAN menu item that 
provides services such as a most-recently-used file (MRU) list. If the user added such 

a menu item to a referenced menu, then files ac¬ 
cessed in one window would affect the MRU list of 
another window. That may or not be what the user 
wanted, but in any case, there would be little visual 
indication that that behavior was in effect. 
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Although I gave up on the idea of references, I remained 
enamored of the concept of being able to build reusable user 
interface items, such as complete menu structures. For ex¬ 
ample, I wanted to be able to build a standard File menu in 
WUIMAN that I could easily insert into any window in my ap¬ 
plication. At the same time, I was trying to decide how one 
creates new objects in the WUIMAN database. Eventually, I hit 
upon the idea of making “cloning” the fundamental creation 
operator in the WUIMAN database, killing two birds with one 
stone, and simplifying some aspects of the implementation. 

My basic idea for cloning is this: a WUIMAN database for a 
particular application starts its life, not empty, but containing 
an instance of each possible class of WUIMAN object (window, 
menu, button, etc.). Rather than supplying an object creation 
function, the WUIMAN database supports cloning only a por¬ 
tion of the database tree. Therefore, to create a new window, 
you would specify that you wanted to insert into the 
database a clone of the existing “window” object. The clone 
operation would also allow you to specify the depth (number 
of levels of database tree) to clone. That means I could create 
my standard File menu and, whenever I wanted a copy of it 
inserted into a new window, just use the clone operation to 
create a copy of the entire sub-tree that corresponded to the 
standard File menu. 

I've played enough with the cloning concept at the 
prototype stage to convince myself it is relatively intuitive to 
use, at least for a programmer. The cloning idea also solved 
the problem for me of how to expose new WUIMAN classes to 
the user interface. Rather than have an elaborate separate API 
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For discovering what WUIMAN classes are available and for 
creating instances of them, the classes merely automatically 
appear in the WUIMAN database, and you can clone them as 
you can any other part of the tree. You end up manipulating 
your user interface as a visual tree, much as you can manipu¬ 
late your directory structure in File Manager. 

Metaclass Information 

One impediment to building reusable Windows interface 
code is Windows’ weak support for inheriting code. Suppose 
you have a dialog box that needs to contain a child window 
for viewing a file. You almost certainly would decide to sub¬ 
class the standard edit control to accomplish this, rather than 
writing your own control from scratch, since the standard edit 
control provides a large amount of functionality (managing the 
scrollbar, text selection, clipboard access, and so on). The clean 
solution is to create a custom control, perhaps with a window 
class name of “ViewEdit", that has all the privileges of the 
built-in Windows controls, but uses the standard “Edit” control 
class to do most of the work. 

One problem with this approach is that Windows provides 
no way for a program to find out that a “ViewEdit” control is 
derived from an “Edit” control. Why would you ever want to 
do that? Consider Microsoft’s ctl3d.dll, which walks through 
the child controls on a dialog and subclasses them to give 
them a fancy, three-dimensional look. This tool is nearly auto¬ 
matic, except that it fails when it runs into a custom class 
such as “ViewEdit”. Because ctl3d.dll cannot discover 
dynamically that “ViewEdit” is derived from the standard “Edit” 
class, it has to skip over that control just to be safe. The prob¬ 
lem is that Windows supplies little framework for metaclass 
information —i.e., a description of what classes exist and what 
their relationships are. 

WUIMAN has a pressing need to discover the relationships 
between classes at runtime, because it is going to let you 
dynamically connect user interface object events to callback 
functions in your code. Suppose you are using WUIMAN to 
dynamically create a dialog box, and you decide to connect a 
function to the dialog's OK button. Ideally, WUIMAN would not 
just present you with a list of all the possible callback func¬ 
tions that your application had registered, since many of them 
might be inappropriate for this event. One first approximation 
would be to eliminate all the callback functions with inap¬ 
propriate (wrong number or types of arguments) parameter 
lists. Flowever, it would be much better to also avoid display¬ 
ing callback functions that were not designed for this class of 
WUIMAN object. You could accomplish this by requiring the 
application that registers a callback function to specify the 
classes the function can be used with. Unfortunately, this ap¬ 
proach recreates the problem that Windows itself has. 

Suppose WUIMAN offers a class called “TButton” that repre¬ 
sents a simple button and emits an event called “Push” when¬ 
ever the user pushes the button. Your application could 
register with WUIMAN a callback function called “Click", which 
would use the PC speaker to emit a sound like a key click. 
When you registered the “Click” callback, you could specify 
that it was for use only with WUIMAN objects of class “T- 
Button”. Then, the user could connect your callback function 
to the “Push” event of any button, to give it audible feedback. 
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However, what if someone later derives a new WUIMAN ob¬ 
ject from "TButton", called, say, “TGraphicButton”, to provide 
buttons with bitmapped faces? If callback functions can only 
be used with the classes that existed when the function was 
written, your ability to create reusable user interface code 
decreases. 

My solution to this problem is to decide that all WUIMAN 
objects must support a method, called “IsA”, that lets WUIMAN 
(or even application code) check to see if the object is derived 
from a specific class. The "IsA” method takes two arguments: 
first, a WUIMAN class name; second, the name of a WUIMAN 
attribute. If you omit the second argument, then "IsA” must 
return TRUE if and only if the object is derived from and sup¬ 
ports all of the attributes of the named class. If you include 
the second argument (an attribute name), then “IsA” should 
return TRUE if the object is derived from the named class and 
supports the specified attribute. 

Characteristics of AWuiObject 

The WUIMAN database exists for two main reasons: to pro¬ 
vide persistence and to provide communication with user in¬ 
terface objects such as menus, windows, buttons, and so on. 
Persistence basically means that changes that the user makes 
interactively to the user interface (such as moving a button or 
changing a window title) are not lost when the application 
terminates. WUIMAN will load the entire database (which 
describes the application’s user interface) from disk into 
memory at startup, and then save any changes made to it 
while the application is running. As I discussed last month, 
communication with objects in the WUIMAN database takes 
the very general form of getting and setting string attributes. 

One way to look at the WUIMAN database is to compare it 
to the interface between dialog editors and custom controls. 
Microsoft defined (and Borland improved) a specific interface 
to custom controls for dialog editors. If your custom control 
abides by this interface, then a tool like Borland’s Resource 
Workshop can load and display your custom control without 
any specific knowledge of what your control does. Likewise, 
Visual Basic can load and display an interface to . vbx custom 
controls without reference to specific code to deal with any 
specific custom control. The WUIMAN is a simpler and more 
general framework that can provide an interface to any and 
all aspects of the user interface. 

Beware of any class whose name contains the word “ob¬ 
ject" — it often indicates a failure to figure out exactly what 
the class is for. My justification in this case is that AWuiObject 
is exceedingly generic. In fact, I will use this class to imple¬ 
ment both user interface objects and their attributes. 

Here’s a summary of the data characteristics I’ve claimed 
the WUIMAN database will have: 

• The database is a hierarchy of user interface objects, of 
type AWuiObject. Each object typically corresponds to a 
user interface element, such as a window or menu. 

• Each AWuiObject has a name and a value (a string). 

• Each AWuiObject has a class name (such as "Window” or 
“Menu”) that identifies what kind of user interface object it 
is. 

• Each AWuiObject can have zero or more child AWuiObject 
objects. 
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Listing 1 Definitions for AWuiObject 


// wuiobjdb.h - Definitions for WUIman OBJect DataBase. 

// Copyright (c) 1993 by Ron Burk 

#ifndef WUIOBJDB_H 
Idefine WUIOBJDB_H 

#if ! (defined(_INC_WINDOWS) || defined(_WIND0WS_H)) 

#include <windows.h> 

#endif 

linclude "wuistd.h" 
linclude "wuiname.h" 
linclude "wuiargs.h" 
linclude "wuilist.h" 

class AWuiObject; 

II TWuiObjects - a list of type TWuiObject 
class TWuiObjects : public TWuiGenericList 

i 

public: 

TWuiObjects(int Size=0); 

void *Insert(AWuiObject *NewObject, const TWuiName To); 

void *Insert(AWuiObject ‘NewObject, int Position=-l); 

AWuiObject *Get(const TWuiName Which); 

AWuiObject *Get(int Position); 

AWuiObject *Remove(const TWuiName Which); 

AWuiObject *Remove(int Position 1 -1); 
int N0bjects(); 

private: 

int Find(const TWuiName Which); 

): 

inline 

AWuiObject ‘TWuiObjects::Remove(int Position) 

{ MEMBERASSERT(); 

return (AWuiObject *)TWuiGenericList::Remove(Position); 
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• Each AWuiObject can have zero or more attributes. 

• No two child objects of an AWuiObject can have the same 
name and no two attributes of an AWuiObject can have 
the same name, but an AWuiObject can have a child ob¬ 
ject and an attribute with the same names. 

Abstract Classes 

The WUIMAN database will contain C++ objects of different 
types; for example, the C++ object that implements a window 
will be different from the one that implements a menu. 
Despite this fact, WUIMAN must be able to manipulate all 
these different objects with a uniform set of operations so 
that it can provide a single user interface for all object types, 
even object types that are created in the future. To ensure 
that all the objects in the database supply the functions 
WUIMAN needs to manipulate them, I require that they all be 
derived from a single root class, AWuiObject. I can make the 
role of AWuiObject more explicit in C++ by making it an 
abstract class. 

The syntactical definition of an abstract class is pretty 
simple: an abstract class is any base class that has at least 
one pure virtual function. A pure virtual function is a virtual 
function that has =0 appended to its declaration. For example, 

class Foo { II... 

virtual int Count() = 0; 

}; 


declares a pure virtual member function called Foo::Count (), 
which makes class Foo a virtual class. This odd little syntax 
has little mnemonic value, but has a large effect on what you 
can do with the class: you cannot ever create or declare an 
instance of class Foo. 

What good is a class if you can’t ever instantiate it? One 
answer is that it is good for defining interfaces. In my case, 
AWuiObject will define the characteristics that all objects in 
the WUIMAN database have in common. To define a specific 
WUIMAN object (such as a menu), I will derive a class from 
AWuiObject (or one of its descendants), thus ensuring that it 
abides by the interface that AWuiObject defined. In effect, the 
AWuiObject class definition is a boilerplate for all objects in 
the WUIMAN database. Since objects in the database are 
derived from AWuiObject, they can always be manipulated via 
a pointer of type AWuiObject *, and they must supply the 
operations that AWuiObject class declaration defines. 

When you create an abstract class, you have to figure out 
how the code that uses it will be able to obtain a pointer to a 
concrete object derived from the class. For example, suppose 
you created an abstract class that encapsulated the details of 
PC network file I/O (different PC networks can offer incom¬ 
patible forms of record locking): 

class NetIO {//... 

int Lock(int RecNo) = 0; 
int Unlock(int RecNo) = 0; 

II... 

}; 


The rest of your code might contain calls like this: 
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extern NetIO *ThisNet; 

ThisNet-Lock(CurrentRec); 

and be insulated from network-specific details. However, 
someone has to implement concrete classes derived from 
NetIO for each network (such as Novell and Banyan), and you 
have to arrange for your more general-purpose code to obtain 
pointers to the correct objects for the network being used. 

One solution in this example would be to detect the cur¬ 
rent network being used at startup, create a new instance of 
the corresponding NetlO-denved class, and store a pointer to 
this instance in a global variable of type NetIO *. If your 
machine can only be connected to one type of network at 
once, this is probably an acceptable solution. 

One small payback for the extra work of using abstract 
classes is that they can save some recompilation. In the pre¬ 
vious example of the NetIO class, you could completely 
change the implementation of the concrete classes that im¬ 
plement specific network I/O and never have to recompile the 
code that uses them. Since you can only access these classes 
via a pointer to the abstract class, the compiler does not need 
to know anything about the implementation code (such as 
the actual size of a particular network I/O object). 

One complaint about C++ is that a small change (even to 
private members) of a heavily-used base class can require 
you to recompile an entire project. You could use abstract 
classes throughout a design to minimize this problem. You 
can also view abstract classes as a way to separate the type 
system of your program from its class structure. In fact, a lan¬ 
guage called School (which adds a secure type system to 
Smalltalk concepts) takes precisely this approach. In School, 
you first declare a type (basically the set of member functions 
applicable to classes of that type), then you can declare a 
class of that type, which implements member functions and 
defines any data members needed. You can more or less 
emulate this approach in C++ by first designing abstract clas¬ 
ses that only contain pure virtual functions and then making 
sure all your other classes are derived from one of these 
abstract classes. 

Why doesn’t everyone use abstract classes for everything? 
One reason is efficiency. The less the compiler knows about a 
class, the less optimization it can provide. You can’t embed an 
instance of an abstract class in another class because the 
compiler doesn’t know how big it is; instead, you have to pay 
for a dynamic allocation and store a pointer to the instance. 
Another reason is laziness. Using abstract classes throughout 
your design means an extra layer of work, since every 
abstract class will need at least one derived concrete class to 
be of any use. As usual with C++, you have to use your judg¬ 
ment and take the approach most appropriate for the project 
at hand. 

The question remains: how will WUIMAN objects in the 
WUIMAN database come into existence? AUuiObject contains 
a virtual function for each aspect of WUIMAN core object 
functionality, but you can’t have a virtual constructor to define 
how objects are created. Instead, AWuiObject defines a pure 
virtual function called New() that allocates a new object of the 
same type as the current object. That creates a chicken-and- 
egg problem: you can’t create a WUIMAN object unless you 
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Listing 1 continued 


I 

inline 

AWuiObject *TWuiObjects::Get(int Position) 

{ MEMBERASSERTO; 

return (AWuiObject *)TWuiGenericList::Get(Position); 

) 

inline 

int TWuiObjects::NObjects() 

( MEMBERASSERTO; 

return TWuiGenericList::NE1ements(); 

} 

class AWuiObject 
( 

public: 

AWuiObject(const TWuiName ObjectName, 

const char ‘Value = 0); 


virtual 


~AWuiObject(); 

virtual 

AWuiObject 

*Clone() = 0; 

virtual 

AWuiObject 

*New(const TWuiName Name, 

const char *Value) = 0; 

virtual 

TWuiObjects 

*Children(); 

virtual 

TWuiObjects 

*Attributes(); 

virtual 

long 

Get(const char *Path, 

TWuiArgs *Args, 
AWuiObject *Attribute, 
char *Buffer, size_t MaxLength); 

virtual 

long 

Set(const char *Path, 

TWuiArgs *Args, 
AWuiObject *Attribute, 
char *Buffer); 

TWuiName 

Name(); 

static 

vate: 

AWuiObject 

*Root; 

TWuiName 

Name ; 
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Listing 1 continued 


I; 

inline 

TWuiName AWuiObject::Name() 

{ 

return Name ; 

} 

class TWuiRegister 
{ 

public: 

TWuiRegister(AWuiObject *MasterCopy); 
}; 

lendif 

/* End of File */ 


already have an object of that type, so where did the first 
object come from? 

My solution is in two steps. First, a pointer to the root node 
of the WUIMAN database resides in a public static variable 
named AWuiObject:: Root. Each WUiMAN class will be respon¬ 
sible for adding an instance of itself (complete with whatever 
attributes it supports) under the node “/Classes” at startup 
time. The object should have the same name as the class. 
Second, when WUIMAN needs to create a WUIMAN object of a 
particular class, it first locates the corresponding object name 
under “/Classes”. Given a pointer to that object of the desired 
type, it can then call its New() function to create a new object 
of the same type. 
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The idea of storing an instance of each class type under 
“/Classes” is just a convention. Rather than scatter depend¬ 
encies on this convention throughout the code, AWuiObject 
supplies a helper class, called TWuiRegister, whose construc¬ 
tor accepts a pointer to a WUIMAN object, which it then in¬ 
stalls under the “/Classes” node. I could have just supplied a 
static function like AWuiObject::RegisterClass() to do the 
trick, but TWuiRegister makes it easy to get your class 
registered at startup time by using a construct like this: 

static TWuiRegister 

Register(new 

MyWuiClass("MyWuiClass")); 

The constructor for the static variable Register will get called 
at startup, guaranteeing that the class is registered before 
WUIMAN loads its database from disk. 

Summary 

wuiobjdb.h (Listing 1) contains the declaration for AWui¬ 
Object. The header file first derives a simple extension of the 
generic list class described last month for containing lists of 
AWuiObjects. The AWuiObject constructor takes a name 
(every WUIMAN object must have a name) and a string value. 
The string value supplies whatever initialization information 
the class cares to store for itself. 

The Clone() member function is responsible for creating 
an identical copy of a given WUIMAN object. Any class derived 
from AWuiObject must supply its own virtual function to do 
this. Likewise, each derived classes must supply its own New() 
member function to create a new instance of the derived class. 

A WUIMAN class may or may not have children or at¬ 
tributes, so rather than make these lists part of the basic ob¬ 
ject structure, I have virtual functions {Children() and At¬ 
tributes ()) return pointers to them. If a derived class can 
have child objects, it will simply override this function to 
return a pointer to the list of child objects. 

The Get () and Set() functions define the interface for get¬ 
ting and setting values. They rely on the TWuiArgs class 
defined in a previous column. Finally, the Name() member 
function simply returns the object's name. It is inline and non¬ 
virtual, mostly for efficiency, and since I don't see much need 
for ever overriding it. 

Next month I will supply the code to implement AWui¬ 
Object and container objects and attributes. 
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Windows 

Network 

Programming 

How to Surpive in a World of 
Windm% DOS, and Networks 


RALPH DAVIS 


Windows Network Programming 

Reviewed by Victor R. Voikman 


Introduction 

Windows Network Programming, by Ralph Davis, is sub¬ 
titled How to Survive in a World of Windows, DOS, and Net¬ 
works. The book strives to cover the widest possible range of 
network communication and service APIs. The ultimate goal is 
to help your applications take full advantage of networking on 
the widest possible selection of environments. The first section 
covers network communications APIs for NetBIOS, Novell 
IPX/SPX, Banyan VINES Sockets, and the Windows Sockets API. 
Next, Davis tackles network service APIs for generic Windows 
network drivers, Novell NetWare, MS LAN Manager, and 
Banyan VINES. The final section presents general descriptions 
of networking applications in Windows NT, Win32 API, and the 
Windows For WorkGroups SDK. 

Although the book covers diverse APIs, it omits such sig¬ 
nificant alternative APIs as the Lantastic Programmers Interface 
for Windows, the Sun Microsystems PC-NFS Programmers 
Toolkit, and the NetManage Inc. NEWT-SDK. Each of these ven¬ 
dors has offered Windows network APIs for at least two years. 
The NEWT-SDK, for example, includes a complete suite of BSD 
socket calls plus DLL-level interfaces for TCP/IP File Transfer 
Protocol (FTP) and the Simple Mail Transfer Protocol (SMTP). 


Further, the book excludes consideration of heterogenous 
client/server environments, such as Windows-to-DOS and Win- 
dows-to-UNIX. Rather, the complete thrust is for Windows-to- 
Windows communication. To be fair, the general algorithms 
presented for Windows can be applied to alternate platforms. 
However, as I explained in my article on Windows Sockets 
(Windows/DOS Developer’s Journal, December 1992), the BSD 
UNIX socket calls differ in significant ways from Windows 
Sockets at the source level. 
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Windows Network Programming 

by Ralph Davis 
ISBN: 0-201-58133-7 
Addison-Wesley, 1993 (first edition) 
$29.95 
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Figure 1 Functions in the network-independent communications DLL 

Function 

What it does 

WNetCallO 

Initiate connection to other PC 

WNetListenO 

Accept connection requests from other PC 

WNetSendO 

Send packet over connection 

WNetReceiveO 

Receive packet over connection 

WNetHangupO 

Terminate connection 

WNetSendDatagramO 

Transmit a datagram 

WNetReceiveDatagramO 

Make buffer available for receiving datagram 

WNetPostMessageO 

Send message to specified window on other PC 

WNetSendMessageO 

Send message to specified window on other PC 

WNetFindWindowO 

Find window handle based on title, class and PC Name 

WNetEnumStationsO 

Find other PCs that are running this driver software 

WNetlnitO 

Initialize DLL 

WNetShutdownO 

Terminate DU 

WNetGetNameO 

Determine host name of this PC 

WNetGetNameLengthO 

Length of host names 

WNetSetNameO 

Change name of this PC 

WNetShipDataO 

One-shot open, send, receive, and close 

WNetSetLastErrorO 

Save this error number 

WnetGetLastErrorO 

Retrieve last error number 
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Windows Network Programming 
starts with the unwritten assumption 
that the reader knows the C language 
well, knows a little assembler, and has 
written sophisticated Windows 
programs involving Dynamic Data Ex¬ 
change (DDE). Also, unless you're 
familiar with at least one networking 
communications API (for example, DOS 
NetBIOS I NT 5CH), you may have to 
study other background materials first. 

Network Communications 

The development of a network-inde¬ 
pendent API for peer-to-peer com¬ 
munications motivates the discussion of 
the various network communications 
APIs. The author first describes his own 
new API layer which sits above all other 
communications APIs, thus isolating 
their dependencies from the developer. 
This new API layer not only includes a 
full suite of datagram and session- 
oriented communications, but also 
handles a limited form of Remote Pro¬ 
cedure Calls (RPC). The RPC implementa¬ 
tion allows you to find and post mes¬ 
sages to application windows on 
remote PCs. One of the example 
programs even attaches to the Program 
Manager on the remote PC to install 
icons in it via Dynamic Data Exchange 
(DDE). 


The first half of the book tells how 
Davis implements this new API layer on 
top of NetBIOS, Novell IPX/SPX, Banyan 
VINES Sockets, and the Windows Sock¬ 
ets API (see Figure 1 for a complete list 
of API functions in the communications 
DLLs). As you might expect, a different 
DLL file must be created for each of 
these environments (NetBIOS, Novell, 
etc.). The author even provides a 
method of detecting the active environ¬ 
ment and dynamically installing the cor¬ 
rect DLL. The total functionality of 
Davis’s network-independent API com¬ 
pares well with products that cost as 
much as (or more than) a thousand dol¬ 
lars. 

After the introduction of the general 
principles and common code for the 
network-independent communications 
layer, each succeeding chapter covers 
the gritty details of implementing the 
generic layer using the specific API calls. 
In the case of NetBIOS, which doesn’t 
have an existing C-callable interface in 
Windows 3.x, this involves considerable 
C and even some assembly language 
code. Each network-specific DLL imple¬ 
ments approximately the first nine of 
the API calls listed in Figure 1. 

The down side of providing one 
generic API layer for each environment 
is that it necessitates a “least common 
denominator” approach. In other words, 


Figure 2 Functions in the Network-Independent Services DLL 

Function 

What it does 

WNetEnu mServersO 

List all servers of any type requested 

WNetAddUserO 

Authorize a new user to access the network 

WNetDeleteUserO 

Remove network access for a user 

WNetEnumUsersO 

List all users 

WNetAddGroupO 

Create a new group name for network access 

WNetDeleteGroupO 

Remove network access for this group 

WNetAddGroupMemberO 

Add new member to existing group specified 

WNetDeleteGroupMember 

Remove this member from existing group specified 

WNetlsUserGroupMember 

Asks whether the user belongs to specified group 

WNetEnumGroupsO 

List all groups 

WNetEnumGroupMembers 

List all members of specified group 

WNetEnumMemberGroups 

List all groups that this user is a member of 

WNetGrantRightsO 

Allow access by permission mask 

WNetRevokeRightsO 

Deny acess by permission mask 

WNetGetRightsO 

List rights of specified user 
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only the bare minimum functionality supported on all net- 
work-specific APIs can be applied, with the result that unique 
extensions of each environment tend to be ignored. For ex¬ 
ample, although Windows Sockets API supports out-of-band 
data, none of the other environments does so natively. Since 
emulating out-of-band data would be difficult, it receives little 
consideration. 

Overall, the chapters on network-specific communications 
APIs are well researched. The text is strongest on Novell Net¬ 
Ware and weakest on Windows Sockets. The Windows Sock¬ 
ets coverage suffers in part because, as Davis notes (p. 218), it 
was not tested before publication, and in part because the 
Windows Sockets specification has been updated to revision 
1.1 since the book was published. The descriptions of hosts, 
services, and ports seem a bit too brief. 

Network Services 

The second half of the book considers the network ser¬ 
vices APIs of Windows built-in functions, Novell NetWare, MS 
LAN Manager, and Banyan VINES. Both Windows Sockets and 
NetBIOS APIs are excluded because they offer only com¬ 
munication services. Windows for WorkGroups network ser¬ 
vices are omitted since they duplicate MS LAN Manager in the 
functional areas under consideration. 

The vast umbrella of “network services" covers basically 
every API call other than those related to client/server com¬ 
munications. Minimally, this encompasses mounting network 
drives, exporting local drives, finding out who’s logged in, ad¬ 
ding and deleting users and groups, submitting print jobs, 


monitoring network performance and operation, supporting 
long filenames, and assigning rights to files and directories. 
Davis considers applications centered on network services to 
be “vertical applications." 

The diversity of the network services offered by the 
various network environments greatly outweighs the diversity 
of communications services. For example, the basic built-in 
Windows network services consist of just 40 function calls 
while Novell NetWare publishes nearly 400. Again, Davis boils 
down the various APIs to their least common denominator. 
What remains is a set of 15 functions for managing users, 
groups, and their network access rights (see Figure 2). 

However, even this reduced set of functions is of limited 
use in the vast majority of network applications. First, these 
functions must respect the built-in security of the native net¬ 
work. This implies that only users with system administration 
authority could successfully execute functions which modify 
users, groups, and their rights. Second, the functions have little 
relationship to workaday applications such as word process¬ 
ing, spreadsheets, databases, or communications. They might 
serve best as convenience functions in a groupware ad¬ 
ministration utility. 

The network services discussion provides the most help by 
documenting the actual levels of support of built-in Windows 
network functions (chapter 9). The built-in functions are those 
actually exported by the network-specific driver in the “net- 
work.drv" entry of the “[boot]” section in SYSTEM. INI. Many of 
these functions are listed as optionally supported by the 
Microsoft Windows Device Development Kit (DDK) documenta¬ 
tion. Davis runs through the complete 
set and shows which networks really 
support which functions. In addition, he 
shows the actual dialog boxes as¬ 
sociated with each network. 

Other APIs 

The final part of the book, just over 
50 pages, quickly sketches network APIs 
in Windows NT, Win32 API, and the 
Windows For WorkGroups SDK. Chapter 
13, on Windows NT and the Win32 API, 
covers mainly named pipes and 
maiislots. The text falls short of giving 
an implementation of the network-in- 
dependent communications layer based 
on named pipes or maiislots. It does in¬ 
clude patches to the NetBIOS im¬ 
plementation to fulfill a network-inde¬ 
pendent communications layer for Win¬ 
dows NT. The Windows NT RPC compiler 
receives only passing mention. 

The Windows For WorkGroups 
coverage outlines the additional WNet 
functions, Messaging API (MAPI), LAN 
Manager equivalent functions, and 
NetDDE. Unlike previous chapters, this 
one does not include environment- 
specific source code. 
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Commentary 

Computer networking literature sometimes sticks too close 
to the theoretical aspects while studiously avoiding practical 
implementation issues. Davis takes the uncommon approach 
of providing too much practical implementation and not 
enough background theory. In particular, the text bypasses 
common networking background topics such as physical 
transports, packet internals, Open Systems Interconnect (OSI) 
communication layers, addressing and name resolution, and 
routing. Others topics, such as Remote Procedure Calls, are im¬ 
plemented without much preamble. Instead, the text sticks to 
issues revolving around Windows device drivers, blocking, and 
page-locking communications buffers. The more than 100 
pages of source-code listings reflect the dominance of practi¬ 
cal implementation over design theory. 

The source code itself presents something of a dilemma to 
the reader. First, the prospect of typing in the many pages of 
code needed to demonstrate the techniques seems daunting. 
Many books of this genre come complete with a bound-in 
diskette of source or object code, if the diskette is not in¬ 
cluded, the publisher typically offers a mail-in coupon for an 
extra charge or even access by anonymous FTP. None of these 
options appears available for Windows Network Programming. 
Further, it is unclear whether you have the license to use the 
code even if it were available, because all of the files contain 
additional copyrights stamped with “All Rights Reserved. 1 ’ Last, 
the absence of makefiles reinforces the idea that the reader 
may look at, but not touch, the source code. 
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Precise thinking, whether in computer science or 
philosophy, hinges directly on definition and usage of ter¬ 
minology. The book uses accepted terminology in nearly all 
cases. Flowever, the text defines a few concepts in a unique 
way. For example, the distinction between “horizontal applica¬ 
tion” and “vertical application” makes one such case. Davis 
defines a horizontal application as an application that com¬ 
municates across a network to another application. Fie con¬ 
trasts this with a vertical application, which he defines as an 
application that seems to “execute within a single worksta¬ 
tion" but really talks to a server. These distinctions create a 
useless dichotomy that applies only loosely to DOS and Win¬ 
dows applications and not at all to other platforms (e.g., UNIX). 

Another issue of terminology has to do with the distinction 
between “client-client” and “client-server" communications. 
Davis defines server in the most narrow sense —as a Novell 
dedicated file server which cannot be used as a network 
workstation. Thus only applications which run on the server, 
such as NetWare Loadable Modules (NLMs), would qualify as 
servers. However, the notion of dedicated file servers appears 
almost exclusively in PC networks and diminishes further with 
the growing popularity of peer-to-peer networks. This fixed- 
role distinction (a PC must be either client or server) ignores 
the fact that a PC can simultaneously act as client and server 
even under a plain DOS environment (e.g., a NetBIOS applica¬ 
tion). 

The most confusing bit of terminology lies with the API 
naming itself. Windows uses its own naming convention of 
prefixing the network driver supplied functions with the string 
“WNet”. For example, WNetAddConnection() is declared as 
such in the windows, h file of your Windows SDK. However (as 
I explained earlier this year in my article on the Windows for 
WorkGroups SDK in Windows/DOS Developer's Journal April 
1993), there already exists a large number of Microsoft-defined 
“WNet” functions with grossly varying levels of support in 
Windows 3.0, 3.1, Win32 API, NT, and WFWG. 

By mimicking the “WNet” naming convention, Davis adds 
his own flavor into the existing soup. For the reader, the con¬ 
fusion lies in continually remembering whether a given func¬ 
tion is one written by Davis or one supplied by Microsoft. The 
book at least ought to have a master list showing which func¬ 
tions are Microsoft and which are not. Choosing some other 
prefix (e.g. “RNet”) would have prevented the confusion. 

Conclusion 

Windows Network Programming demonstrates a grand 
unification of disparate networking communication and service 
APIs. If you study them carefully, the implementations given 
could help you avoid many programming pitfalls for multi¬ 
platform networking applications. Those looking for solutions 
based on NetBIOS, Novell NetWare, and Banyan VINES can 
benefit the most from this book. Those interested primarily in 
Windows Sockets might benefit more from traditional texts such 
as Stevens’ Unix Network Programming or Comer’s Internetwork¬ 
ing with TCP/IP (vols. I through III). Those interested primarily in 
Windows For WorkGroups should look elsewhere. □ 
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Edited by 
Leor Zolman 


Please send us your best 
tricks and hacks —those 
clever pieces of code to 
make things work the 
way they should! You’ll 
receive at least $50 for 
each tip that we print 
Send your submissions to.- 
Tech Tips 
Leor Zolman 
74 Marblehead Street 
North Reading, MA 01864 
leor@bdsoft.com. 


Windows programming has a reputation for being gratuitously complex. Our 
first Tip this month, however, shows just how short and simple a “trivial'' Windows 
application can actually be. Just because most applications have message loops, 
after all, it doesn't mean that they all have to .. . -Iz 


Writing Simple Windows Programs 


Karl D. Schrey 
1628 Fieldgate Ave. 
Hacienda Heights, CA 91745 


My four computer-game-playing children are one of the reasons I came up with 
the notion of “simple” Windows programs: I wanted to make the kids work at 
programming a little before they could play their games. I started them out with 
DOS batch techniques to start up the games, and then moved up to some simple C 
code where I wrote it all first and then showed them what to modify to make it get 
to their games. Under Windows 3.x, however, the fifty or so lines of code to register 
and create a window, make a message loop, and then use a callback function just to 
start a basic Windows program was a bit too complicated for starters. So they made 
an icon with an icon editor and had Windows open up one game with that icon. 



Leor Zolman wrote BDS Q the first C compiler targeted exclusively for pens onal computers. 
Leor is currently an instructor on UNIX topics for Boston University’s Corporate Education 
Center, a regular contributor to Sys Admin magazine and “Tech Tips" editor for Win- 
dows/DOS Developer's journal. His first book, illustrated C, was published by R&D Publica¬ 
tions, Inc in 1992. He may be contacted at 74 Marblehead St, North Reading, MA 01864, 
or on Usenet/lntemet as-, leor@bdsoft.com. 


















Listing 1 exit_win.c 


Compact program to exit Windows 3.x 
Compile: bcc -W -w- exit_win.c 


int far pascal ExitWindows(unsigned long dwReserved, 
unsigned int wReturnCode); 


int pascal WinMain(unsigned int hlnst, 

unsigned int hPrevInst, 
char far *lpszCmdLine, 
int nCmdShow) 

{ 

ExitWindows(0,0); 
return 0; 

} 

/* End of File */ 


WHEN THE DEBUGGING GETS TOUGH 
REACH FOR ONE OF PERISCOPE'S 
"BUTT-SAVING" DEBUGGERS. 



"Great product, has already 
saved my butt more than once, 
says one relieved Periscope user. 


Just push the “panic button” on the break-out switch (comes with al! PeriscopesI 
when your system locks up. 

SOFTWARE-ONLY 
DEBUGGERS lor dos, 

Windows and OS/2... 

■ Use Periscope/EM to debug real¬ 
mode DOS software, including applica¬ 
tions, drivers, TSRs, and interrupts. 

Run Periscope/EM from conventional 
DOS memory or extended memory. 

■ Use Periscope/32 to debug system- 
level software running under Windows 
3.x, OS/2 2.x, or your own 32-bit 
operating environment. 


RENT OR BUY THE 

HARDWARE when you 
need the power of an ICE... 

■ The Periscope Model IV hardware 
adds the power of an ICE to both 
Periscope/EM and Periscope/32. Debug 
hardware interrupts, communications 
software, real-time software, and in any 
situation where you need zero slow¬ 
down, no-impact tracing or monitoring. 


I developed an “exit'’ icon for my system, so I could exit 
the Windows environment with one double-click. At first I 
used the aforementioned fifty lines of code to accomplish this 
simple task — but is all that code truly necessary? In fact, you 
don’t even need to include windows.h- all you need is the 
bare-bones code shown in exit_win.c (Listing 1) and a com¬ 
panion module definition file (Listing 2). 

I have looked at Borland’s Windows examples and several 
Windows programming books, and all of them start out with 
those fifty lines of code just to say “Hello World.’’ The “Hello 
World” program is a nice little first program to get someone 
started in a new programming language, so I put the good old 
MessageBox() function to work and wrote a single “Hello 
World” program that runs under both Windows and DOS in 
three short pieces of code: hello_w.c 
(Windows, Listing 3), hello_wd.c (DOS, 
Listing 4), and hello_w.de/ (to tie both 
Windows and DOS together, Listing 5). If 
run under Windows, then MessageBox() 
displays the message; if run directly 
from DOS, then the code in 
hello_wd.c() is executed as the "Stub” 
specification in the module definition 
file. The line count for all three of these 
files together is 41, including comments, 
which is less than the length of the 
“typical” mimimal Windows app. In fact, 
if I wanted to write it only for Windows, 
l could reduce that to just fourteen 
lines of readable code by eliminating 
comments, blank lines, extra spaces, 
and use of the “Stub". 

By the way, "make” files and icons 
are not strictly necessary here either. 
The simple syntax to compile with Bor¬ 
land C++ directly from the command 
line without any “make” or project file 
is shown in the comments. Icons do not 
have to be part of the code; Windows 
is more than happy to assign one itself 
if the application does not already have 
one. 

My final example is another little 
app, kids_box.c (Listings 6 and 7) 
designed to teach my kids about the 
MessageBoxf) and UinExec() functions. 


“I've checked out all the various other debuggers as they’ve clamored for 
my keyboard, but Periscope is the one I’ve stayed with." 

Steve Gibson, InfoWortd, May 24, 1993 

Call us TOLL-FREE 800/722-7006 to order 
or for product details and prices. 

PERISCOPE* 


1475 PEACHTREE ST., SUITE 100 • ATLANTA, GA 30309 USA 
404/888-5335 • FAX 404/888-5520 • 800/722-7006 (US & CANADA) 


Listing 2 exit_win.def 


. EXIT_WIN.DEF .. 

Definition file for Windows 3.x C code 


name exit_win 

description 'Exit Windows' 
exetype windows 

code preload moveable discardable 

data preload moveable multiple 

heapsize 1024 

stacksize 5120 


□ Request 231 on Reader Service Card □ 
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I showed them how to make a simple Message Box, and they 
had fun modifying the button styles and changing the mes¬ 
sages for the different games the application can launch. 


Next is the “Technique That Wouldn't Die." The first ver¬ 
sion (May 1993) showed how to avoid multiple instances of 
an application, and a reader responded with a shorter ver¬ 
sion (July 1993). Now here's one that makes them both look 
excessive. I guess the moral of this story is that under Win¬ 
dows, perhaps even more than in the “real” world, there's 
more than one way to skin a cat. —Iz 

Return to Previous Instance, Final Chapter 

(Really!) 


Alex Vinogradov 
2665 Homecrest Avenue #60 
Brooklyn, NY 11235 


The July 1993 Tech Tips contained an article from James K. 
Lawless about returning to the previous instance if another 
instance was launched. I am using a much simpler technique 
in my programs which does the trick using just four lines of 
code: 



if (hPrevInstance) { 

BringWindowToTop (FindWindow ("MainWClass", NULL )); 
return FALSE; 

} 


Listing 4 hello_wd.c 


/* * 

* HELL0_WD.C: DOS-based "Hello World" code, 

* for use as "Stub" in hello_w.exe Windows app 

* Compile: bcc hello_wd.c 
*/ 

#include <stdio.h> 

void main() 

{ 

printf("Hello, World\n"); 

) 

/* End of File */ 


Listing 5 hello_w.def 


■ .HELLO_W.DEF. 

Definition file for Windows 3.x C code 
used by HELL0_W.C source code. It includes 
a DOS version of the code, the "Stub" 


name 

description 

stub 

exetype 

code 

data 

heapsize 

stacksize 


hello_world 
'Simply Hello World 1 
'hello_wd.exe' 
windows 

preload moveable discardable 
preload moveable multiple 
1024 
5120 


Those lines are to be inserted at the very top of WinMain()-, 
MainWClass is the name of the program's main window class. 


Listing 3 heiio_w.c 


/* 

* Windows "Hello World" routine with no shell 

* Compile: bcc -W -w- exit_win.c 
*/ 

linclude <windows.h> 

int pascal WinMain(unsigned int hlnst, 

unsigned int hPrevInst, 
char far *lpszCmdLine, 
int nCmdShow) 

! 

MessageBox(NULL, "Hello World", "Simply", MB_0K); 
return 0; 


/* End of File */ 


The help authoring solution for Windows 

W Y Si-Help 



Our WYSIWYG editor shows you what the final help will look like as you are creating it. To link your help topics to a context you just click 
with the mouse on the button, menu, or listbox you wish to explain. WYSI-Help is compatible with any programming language as well as none 
at all. So you can put help on any application without touching the programming sources. 

This product is now available through IBM's recently announced TRY & BUY technology. 

This means you can download it this very minute from CompuServe® at no additional charges. You pay only your regular 
CompuServe® charges. Then you can try WYSI-Help for 30 days and later decide to buy it. 

DDTEC 1-800-289-1948 
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Listing 6 kids_box.c 


/* 

* Kid's game boxes 

* Compile: bcc -W -w- kids_box.c 
*/ 



linclude <windows.h> 

int pascal WinMain(unsigned int hlnst, 

unsigned int hPrevInst, 
char far ‘IpszCmdLine, 
int nCmdShow) 

{ 

int nMb; 

if (MessageBox (NULL, "Do you want to play SOLITAIRE?", 

"Kids Games", MB_YESNOCANCEL) == IOYES) 
WinExec("SOL.EXE", SWJHOW); 

else if (MessageBox (NULL, "Do you want to play PRINCE?", 
"Kids Games", MB_YESNOCANCEL) == IDYES) 
WinExecC'PRINCE.PIF", SW_SHOW); 
else if (MessageBox (NULL, "Do you want to play Oil's 
Well?", 

"Kids Games", MB_YESNOCANCEL) — IDYES) 
WinExec(“D:\\games\\oilswell\\oilswell.pif", SW_SH0W); 
return 0; 

) 

/* End of File */ 


Now, having just superseded Jim's July '93 Tip by publi¬ 
cation of the previous Tip, I present another Tip by Mr. Law¬ 
less which I’m fairly confident cannot be significantly im¬ 
proved upon ... — Iz 


Listing 7 kidsJ)ox.def 


•.EXIT_WIN.DEF.- 

Definition file for Windows 3.x C code 


name 

description 

exetype 

code 

data 

heapsize 

stacksize 


KIDS_BOX 
'Kids Games' 
windows 

preload moveable discardable 
preload moveable multiple 


1024 

5120 



James K. Lawless 
2414 Fourth Avenue 
Council Bluffs, IA 51501 


I’d like to present a small DOS utility that 1 use to deter¬ 
mine the duration of time a given program will take to ex¬ 
ecute. The program stpwatch.c (Listing 8) accepts one single¬ 
character command-line argument. If this parameter is the let¬ 
ter “R," the initial starting time value is refreshed so that it 


fHands-Qn Windows and C++ Training 


C++ and Windows in a Week! 


menu and dialogs. Using MFC containers and 
Serialization. Eight hands-on exercises. 


Our Most Popular Course Ever! 

We teach experienced C program¬ 
mers the basics of C++ in two days, 
then add three days of Windows 
programming using a C++ class 
library. Our current courses cover 
Visual C++ with the Microsoft 
Foundation Classes and Borland's 
ObjectWindows. We teach all of 
the C++ concepts (encapsulation, 
inheritance, polymorphism) with an 
emphasis on using an application 
framework. The Windows portion 
of the course takes you from square 
one through construction of a 
complete Windows application. 


Call Today To Register. 
Start working in C++ and 
Windows NOW! 

V _ 


C++ in Two Days 

C++ as a better C, objects and the C++ 
class, complete encapsulation, inherit¬ 
ance hierarchies, virtual functions and 
polymorphism, brief coverage of stream 
I/O, templates, and exception handling. 
Four hands-on exercises. This is 
standard C++, independent of any 
platform or vendor (suitable for students 
from UNIX shops) 

Windows in Three Days (Visual 
C++/MFC Version 2.0) 

How Windows works, the MFC classes, 
using App Wizard, Class Wizard, and 
App Studio to build a complete 
Document/View MDI application with 


1 - 800 - 388-3535 

In MD call (301)230-1840 


□ Request 130 on Reader Service Card 


Five days to C++ and Windows! 

You can attend the C++ or Windows part of this 
course separately - if you satisfy the prerequi¬ 
sites. Borland OWL version available. 

/'"■. 11 . 

Upcoming public courses 

Santa Clara, CA November 8-12 
Dallas, TX December 6-10 

(Visual C++) 

Experience Counts! 

&msg has taught C++ and Windows since 
1989. Put our expertise to work for you. 

We have a full range of Windows and C++ 
courses. Instruction on your site is our 
specialty. 

&msg 

Messaging Systems Group, Inc. 

1559 Rockville Pike, Suite 250 
Rockville, MD 20852 _ J 
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contains the current time. If the command-line argument is 
the letter “D,” the current time is compared against the saved 
starting time and the difference is displayed on the standard 
output device. 

While this may sound easy enough to do, when trying to 
implement the program, you may find yourself wondering ex¬ 
actly where to store the initial time value to use as a com¬ 
parator. A tiny area exists at the tail-end of the ROM BIOS data 
area (at segment 40h), known as the intra-application data- 


communication area. This area contains 16 bytes at addresses 
0O4Oh:OOFOh through 0040h:00FFH which are to be used as 
common variable storage areas between transient programs. 
stpwatch.c uses the first four bytes of this area as the initial 
comparator value (via the pointer save_time). 

stpwatch.c also takes the current time directly from the 
BIOS time work area at 0040h:006Ch. This area is a 4-byte 
unsigned long integer which is incremented by 1 with 
each BIOS clock tick at an interval of 18.2 times per second. 


Listing 8 stpwatch.c 


/* 

* STPWATCH.C 

* by 

* Jim Lawless 

* 1622 Ave F 

* Council Bluffs. IA 51501 


* Modified by Leor Zolman 

★ 

* SYNTAX: 

* STPWATCH R 

* STPWATCH D 

* 

*/ 


#include <stdio.h> 
#include <stdlib.h> 

void syntax(void); 


(added tenths of a second) 


resets the timer 
displays elapsed time 
since last RESET 


printf("\nElapsed time: " 

"%21d hours 11 
"%21d minutes " 

"%21d.%lld seconds\n",hours, mins, secs, tenths); 

break; 

default: 
syntax(); 

} 

) 

void syntax(void) 

{ 

printf("Syntax:\n" 

“stpwatch r (reset) or\n" 

"stpwatch d {displayin' 1 ); 
exit(l); 

) 

/* End of File */ 


void main(int argc.char **argv) 

1 

/* save our value in the BIOS intra-app data area. */ 
long far *save_time=(long far *) 0x004000F0L; 

/* pointer directly to the BIOS time */ 
long far *bios_time=(long far *) 0x0040006CL; 

long ticks; 

long tenths, secs, mins, hours; 
long tot_min, tot_secs, tot_tenths; 

if(argc<2) 

syntax(); 

switch(*argv[l]) { 
case 1 R': 
case 1 r': 

*save_time = *bios_time; 
break; 

case 'D 1 : 
case 1 d': 

ticks = (*bios_time) - (*save_time); 

/* Convert ticks to tenths of seconds (div by 182)*/ 
tot_tenths = (ticks * 100L) / 182L; 
tot_secs = tot_tenths / 10; 
tot_min = tot_secs / 60; 

/* Get tenths */ 

tenths = tot_tenths % 10; 

/* Get seconds */ 

secs = tot_secs % 60; 

/* Get hours */ 

hours = totjnin / 60; 

/* Get minutes */ 

mins = totjnin % 60; 
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Listing 9 test.bat 


@echo off 

rem Skeletal test driver for STPWATCH stopwatch program 
rem 

echo Testing the timer. Get ready to start your stopwatch, and 
pause 

stpwatch r 
echo. 

echo Now Timing, 
echo. 

echo To stop the timer, get ready to stop your stopwatch, and 
pause 

stpwatch d 


Unfortunately, DOS defines no protocol for sharing this 
memory, so if you run another program that uses the data 
communication area, it may corrupt the data stored there by 
stpwatch.exe. 


Listing 9 shows a skeletal batch file test driver, test.bat, 
I wrote to help me coordinate pressing the Return key at the 
same time as the buttons on my watch. Just replace the last 
four echo statements and the last pause statement with the 
application you want to time. —Iz 


ATTENTION 
U.S. SUBSCRIBERS 

Correspondence with Windows/DOS Developer’s 
Journal just got easier. We mailed this issue to 
you using a self-adhesive label. 


Your account # Current Expiration 



Just peel off your address label and use it when 
corresponding with us (placing an order, submitting 
reader service cards, address changes, or any 
general correspondence). The information on this 
label will help us in responding to your needs more 
effectively. 

* Please take a moment to examine your 
name and address on the label. If 
anything needs to be changed, please 
contact us. We will correct any errors 
promptly. 

Windows/DOS Developer’s Journal 
Customer Service 

1601 W. 23rd Street Ste. 200 
Lawrence, KS 66046 USA 
VOICE 913-841-1631 
FAX 913-841-2624 
EMAIL pam@rdpub.com 


Keeping Your DLLs Backwards-Compatible 


Moshe Rubin 
59/6 Rechov Shaulson 
Jerusalem, Israel 95400 


The_ export function type modifier is one of my favorites. 

By tacking it on all my Windows applications’ exportable func¬ 
tions, I no longer have to worry about forgetting to export 
them via the module-definition file EXPORTS statement. Ac¬ 
cording to the manual, the_ export modifier can be used in 

an executable or a DLL Until recently, I used to define all 
exportable DLL functions with the_ export modifier. My ap¬ 

plications link to these DLLs, calling the DLL exported func¬ 
tions. However, after adding a new exported function to a DLL, 
the applications would occasionally fail (with a “Call to Un¬ 
defined Dynalink" message), forcing me to relink all applica¬ 
tions that call the DLL. 

The reason is that an exported DLL function is uniquely 
identified by its function ordinal value (run a DLL through EX- 
EHDR or TDUMP to get a list of its ordinals). For example, a call 
to the standard Windows function Createkindow() is a 
dynamic link to user.exe, ordinal 41. Altering a DLL function’s 
ordinal value is a sure-fire way of preventing older applica¬ 
tions from locating the function in the future. The_ export 

modifier might automatically export the function, but it does 
not guarantee a function will retain the same ordinal value. 
Add a new function's source code at the top of the DLL source 
file, compile and link, and watch the ordinal values change. 

The solution is simple: 

1. Explicitly export your DLL functions via the module-definition 
file EXPORT statement specifying the function's ordinal value. 

2. Preserve function ordinal values throughout the lifetime of 
the DLL. Doing so will enable your DLLs to maintain back- 
wards-compatibility. This is what Microsoft has done in 
their DLLs — existing DLL function ordinal values have 
remained unchanged since Windows 1.0. 

If you are calling DLL functions symbolically by using Load- 
LibraryO and GetProcAddress (), then you won’t run into 
this problem. 

if you’ve already distributed your DLL, don’t lose heart. Run 
your latest version through EXEHDR or TDUMP, note the function 
ordinal values, and export your functions via the module- 
definition file. The next time you distribute your DLL, the or¬ 
dinals will be compatible with the previous version. □ 
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New Products 

Industry-Related News & Announcements 


Alligator FFT Library into DLL 

The Prime Factor FFT subroutine library from Alligator 
Technologies is now available as a Windows DLL, making it 
accessible from a variety of Windows programming lan¬ 
guages. The library also now uses the Cooiey-Tukey FFT, the 
Prime Factor FFT, and a DFT to allow analysis on any data set 
size (some FFT packages require the data set size to be a 
power of 2). The library now can transform any data type 
array, including floating-point data types from four to ten 
bytes and integer data types from two to eight bytes. 

The Prime Factor FFT for Windows performs one- and 
two-dimensional FFTs on arrays up to the bounds of virtual 
memory. The library automatically detects and exploits the 


WinGEN Adds Pascal, NT Support 

WinGEN is a GUI database design system for cross-plat- 
form development WinGEN lets you convert interpreted 
ObjectVision applications into compiled applications without 
the ObjectVision title bar or runtime. Buzzwords Internation¬ 
al has added two new products to their WinGEN product 
line. The new packages generate fully commented source 
for Turbo Pascal for Windows 3.1 and C/C++ for Windows NT. 

WinGEN offers a WYSIWYG designer to help you create 
new applications. You can add or change object properties 
at any time during application creation. WinGEN lets you use 


math coprocessor type. The library is hand-coded in assemb¬ 
ly language for speed and offers switchable scaling features 
for more accurate integer FFTs. The library also includes win¬ 
dowing functions, and amplitude and phase calculation 
routines. 

The Prime Factor FFT DLL for Windows costs $395; multi¬ 
user licenses and OEM agreements are available. The pack¬ 
age includes example application programs in BASIC and C. 
For more information, contact Alligator Technologies, P.O. 
Box 9706, Fountain Valley, CA 92728-9706, (714) 850- 
9984; FAX (714) 850-9987. 


a graphical decision tree to design the logic in your applica¬ 
tion. You can calculate field values, specify actions, or run 
other applications. 

Each Windows 3.1 WinGEN version (C/C++, Turbo Pascal, 
Paradox, dBASE) costs $149; WinGEN for C/C++ under Win¬ 
dows NT costs $249. For more information, contact 

Buzzwords International, Inc., RT 1 Bui/ding 215-T, Cape 
Girardeau, MO 63701, (314) 334-6317; FAX (314) 334-0794; 
BBS (314) 335-6048; MCI ID^BUZZWORD. 


Visual/db Offers Network Database Alternative 


Visual/db v3.0 is a network database system for Visual 
Basic programmers that lets you manage standard dBASE 
database and index files. Visual/db uses a BASIC-like syntax 
(Open, Get, Put, Close, etc.) rather than requiring the program¬ 
mer to learn a new API or language. The package needs no 
resident DLLs or multiple VBX files and adds at most 100Kb 
of code to an application, rather than the 800Kb of code re¬ 
quired by the Microsoft Access vl.1 engine. 

The package includes several ready-to-run database 
management programs (Browse, Create, Index, Report) which 
you can modify or use as the basis for new applications. 
Visual/db can store and retrieve graphics and sound objects 


in database files, useful for multimedia applications. 

Visual/db also supplies a database query language and data 
formatting facility. This tool can accept user input to dynami¬ 
cally process record selections, build new index files, and cre¬ 
ate custom reports at runtime. 

Visual/db costs $299 for the network version or $149 for 
a single-user version. The package comes as a commented 
Visual Basic source code module, and includes a 200-page 
manual of syntax and examples. For more information, con¬ 
tact AJS Publishing, Inc., P.O. Box 83220, Los Angeles, CA 
90083, (800) 992-3383 or (310) 215- 9145; FAX (310) 215- 
9135. 


Speech Systems, Inc. Contact Information 

The address and phone number listed in the October mation is: Speech Systems, Inc., 2945 Center Green Court 

New Products column have been superseded. Current infor- South, Ste. C, Boulder, CO 80301; (303) 938-mo. 
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OLE Automation Available in ENABLE 


Although Microsoft plans to use a BASIC-like scripting lan¬ 
guage in their own OLE-automated applications, they do not 
plan to offer this product to third-party developers. Cypress 
ENABLE is a BASIC-like scripting language fills that this gap for 
Visual Basic v3.0 applications. With Cypress ENABLE, users of 
your Visual Basic application can create scripts that launch 
and manipulate other applications via OLE Automation, ac¬ 


Blue Rose Speeds up DATABasic 

Blue Rose Software has released a new version of 
DATABasic for Visual Basic and Visual C programmers. Ver¬ 
sion 2.20 runs up to 30% faster than version 1, with up to 
300 insertions per second. It now contains more than 50 sub¬ 
routines that control everything from database creation to 
data manipulation. An enhanced data dictionary lets users 
create databases without writing any code. 

DATABasic incorporates both hashed indexing, for maxi¬ 
mum speed, and B-tree indexing, for flexibility. You can set 
tables up in dBASE III format, and export or import tables. Vir¬ 
tual file opens let you use one command to open all tables 
and indexes in a particular database. The package accepts 
any number of keys in a field, in any order, using numeric or 


cess any DLL (including ODBC), and automate tasks within 
your application. 

Cypress ENABLE costs $5000 as an OLE Automation Serv¬ 
er. For more information, contact Cypress Software, 55 39 
South Wilkinson Rd., Langley, WA 98260, (206) 221-2005; 
FAX (206) 341-1568. 


string types. You can place multiple indexes on a single 
table, and you can use both hashed and B-tree indexes on 
the same table. You can instruct DATABasic to keep records 
on linked lists for faster record retrieval. An index cache 
works in single-user mode to speed up searches by caching 
indexes in expanded memory. An alternate collating se¬ 
quence lets non-English applications design their own sort¬ 
ing sequence. DATABasic supplies a two-byte date field that 
helps reduce the storage requirements of date-intensive ap¬ 
plications, such as General Ledgers. 

DATABasic V2.20 costs $189. For more information, con- 
taa Blue Rose Software, Inc., 5246 Durham Lane, Lilburn, 
GA 30247, (404) 717- 1225; FAX (404) 806-9393. 


Crescent Updates VB Libraries 

Crescent Software has updated QuickPak Professional, a 
collection of routines and custom controls for Visual Basic. 
The following custom controls are data aware, for use with 
Microsoft Access databases: a 256+ color picture control that 
supports .bmp, .gif, and .pcx files with zooming, panning, 
and PostScript printing; six input/edit controls for text input 
with masking capabilities, numeric and currency data types, 
and data and time controls; a new data aware listbox and 
combobox; two new data aware frame controls, one with 
radio buttons and the other with checkboxes; 3D label and 
group box controls; a monthly calendar control that can be 
linked to any date field; a command button to provide 
database navigation; and a spin button control that lets you 
display or set a numeric value in a database. The library sup¬ 
plies other custom controls, as well as low-ievel routines for 


tasks such as array manipulation, sorting and searching, and 
more. 

Crescent has also updated PDQComm for Windows, a 
communication control included in the Microsoft Professional 
Toolkit for Visual Basic. The control now offers automatic ter¬ 
minal emulation and binary file transfer protocols, including 
CompuServe B, XModem, XModem-lK, YModem, ZModem, 
and plain ASCII. Terminal emulations include ANSI, DEC VT52, 
DEC VT-100, and TTY terminals. The control lets you access 
multiple serial ports, and includes a complete set of callable 
routines to emulate the standard BASIC syntax. 

QuickPak Professional v2.1 costs $199 and upgrades cost 
$49; PDQComm v2.0 costs $149 and upgrades cost $49. For 
more information, contact Crescent Software, Inc., 11 
Bailey Avenue, Ridgefield, CT 06877, (203) 438-5300; FAX 
(203) 431-4626; CompuServe: 72657,3070. 


Object Skipjack —OO API for Pascal/d BASE/TV 


Object Skipjack is an object-oriented, dBASE-compatible 
API that integrates Borland’s Pascal products, dBASE, and 
TurboVision via more than 40 objects and 700 methods. 
TurboVision is Borland's Pascal class library that mirrors the 
Windows GUI. Object Skipjack provides a dBASE-style 
SAY/GET interface for forms, fields, buttons, lists, and boxes. 
The product is compatible with dBASE. dbf (database), .ndx 
(index), and .dbt (memo) fields, providing a dBASE-style API 
for quickly converting existing dBASE applications. Program¬ 


mers can toggle between multi- and single-user applications 
with just one compiler directive. 

Object Skipjack costs $249 through 1993, and $299 start¬ 
ing in January. A competitive upgrade is available for $ 199 to 
Foxpro, Topaz, and Clipper users and comes with two 
manuals and full source code. For more information, contact 
Object Skipjack, 1 East Chase Street, Suite 1113, Baltimore, 
MD 21202, (410) 783-2668; FAX (410) 783- 2912. 


Sound Plus Plays .wav files, even with no Sound Card 


TegoSoft has released TegoSoft Sound Plus v3.2, a 
software package that lets Visual Basic programmers add 
voice and music to their applications. A Visual Basic program 
can use Sound Plus to detect whether a sound card is in¬ 
stalled and direct the sound to either the sound card or to 
the built-in PC speaker. The sound card can be any Windows- 
compatible sound card, and the sound files can be any . wav 


files. You can use Sound Plus to synchronize voice and music 
with moving text and graphics, to create multimedia applications. 

TegoSoft Sound Plus v3.2 costs $29.95 and comes in the 
form of Windows DLLs. For more information, contact Tego¬ 
Soft Inc., P.O. Box 389, Bellmore, NY 11710, (516) 783- 
4824; FAX (516) 783-5943. 
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Black Ice Updates TIFF SDK 

Black Ice Software, Inc., is shipping version 4.0 of the TIFF 
Software Development Kit. The TIFF SDK lets programmers 
add TIFF image support to their Windows applications. The 
more than 50 TIFF library functions make it easy to read, 
write, encode, and decode TIFF, CCITT, IBM's MMR, and user- 
defined images under Windows 3.x without having to learn 
the Tag Image File Format 

The new version of the SDK supports new high-speed 
Group 3 and 4 fax file formats. This version lets you 


decompress from memory, decompress from every repaint, 
handle LZW and Packbit compression, and handle 24-bit 
color images and chained images. The package also includes 
functions geared toward specific Windows development 
tools and programs, such as Visual Basic v3.0, Actor, SQL Win¬ 
dows, ColorFax, and GammaFax Board. 

The Black Ice TIFF SDK v4.0 costs $299.95. For more infor¬ 
mation, contact Black Ice Software, Inc., 11 3 Route 122, 
Amherst, NH 03031, (603) 673-1019; FAX (603) 672-4112. 


WinScope Provides Deluxe Snooping 

The Periscope Company is shipping the initial release of 
WinScope, a new discovery and debugging tool for Windows 
programmers. WinScope is a high-level, non-intrusive, event 
capturing tool that lets developers spy on arbitrary Windows 
applications. Like normal spy utilities, WinScope can capture 
and display window messages, but it can also intercept API 
calls, including parameter names and return values, as well 
as message filter hooks, Toolhelp notifications, and debug¬ 
ging kernel messages. You can set breakpoints to view 
specific events or pass control to a source-level debugger 


such as CVW, TDW, or the Visual C++ integrated debugger. 
WinScope doesn’t modify the flow of events or API calls, it 
simply intercepts the events you select and records them in 
a trace buffer, where you can search for specific events, and 
display, print, or save them to disk for later examination. 

WinScope costs $199. For more information, contact The 
Periscope Company, 1475 Peachtree Street, Suite 100, At¬ 
lanta, GA 30309, (800) 722-7006 or (404) 888-5335; FAX 
(404) 888-5520. 


Debug NT Memory Problems with SENTINEL 


SENTINEL vl.4 Debugging Environment for Windows NT is 
a memory debugging tool for Windows NT. SENTINEL is a 
library of routines you can link into C and C++ programs to 
help locate and resolve dynamic memory bugs. The package 
provides runtime verification of pointer usage and dynamic 
memory allocation. SENTINEL traps memory errors, and 
reports the source file, function name, and line number of 


the offending statements. The tool is also available on a 
variety of UNIX platforms. 

SENTINEL vl.4 Debugging Environment for Windows NT 
costs from $395 to $995, depending on the platform. For 
more information, contact Virtual Technologies, Inc., 46030 
Manekin Plaza, Suite 160, Dulles, VA 20166, (703) 430- 
9247 or (800) 296-3000; FAX (703) 450-4560; Internet 
info@vti.com. 


ProtoView Creates Custom Controls, Repackages GUI Generator 


WinControl Library is ProtoView's new package of 14 cus¬ 
tom controls for C/C++ and Pascal programmers. The controls 
help create 3D applications, and add context sensitive help, 
DDE links, data validation, user-defined error messages, cus¬ 
tom colors, and custom fonts to applications. Controls in¬ 
cluded in the WinControl Library can fill list boxes with 
directory listings, launch programs from buttons, bitmaps, 
and icons, let users select from four different types of 3D ef¬ 
fects, display the current date, handle DDE messages, display 
tables in listboxes and comboboxes, place bitmaps and icons 
on pushbuttons, set custom colors and fonts, offer clipboard 
and mouse support, create context-sensitive help, set data 
validation for range checking, choice checking, table lookup, 
and mandatory fields, set protected fields, and provide pic¬ 
ture masked input formatting. 


ProtoView has also replaced their suite of GUI develop¬ 
ment tools (ProtoGen and ProtoView) with ProtoGen+, an in¬ 
tegrated visual development workbench for C/C++ and 
Pascal Windows application developers. The GUI designer in¬ 
cludes a live, interactive test mode, as well as range valida¬ 
tion, choice checking, DDE link field editing, complete MDi 
support, toolbar support, dynamic status line functions, cus¬ 
tom colors, custom fonts, and 3D effects. 

ProtoGen+ costs $395; owners of ProtoGen can upgrade 
for $99.95. The WinControl Library costs $249, or $495 with 
source code. For more information, contact ProtoView 
Development Corporation, 353 Georges Road, Dayton, NJ 
08810, (908) 329-8588; FAX (908) 329-8624. 


Engineering C++ Classes Get New Features 


Meijin++ is a large collection of C++ classes that cover 
numerical and statistical analysis, semi-persistent containers, 
digital signal processing, simulation, optimization, and linear 
algebra with four independent error-handling mechanisms. 
New features in Meijin++ v3.0 include: integral and peak 
detection functions, 19 new probability and cumulative dis¬ 
tributions with three different uniform variates, ranking and 
goodness-of-fit test for Gaussian, uniform, and exponential 
random variables, high-order polynomial interpolation, non¬ 


linear regression, neural networks, cellular automata, new 
DSP classes (such as the fast wavelet transform and Kalman 
filter), and boundary-value methods for dynamic systems. 

Meijin++ v3.0 costs $845 for the DOS/Windows version, 
which is compatible with Borland, Zortech, Microsoft, 
Metaware, and Watcom C++ compilers. For more informa¬ 
tion, contact Network Integrated Services, Inc., 221 West 
Dyer Road, Santa Ana, CA 92707-3426, (714) 755-0995; 
FAX (714) 433-2347. 
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Premia Offers VC Add-on and Codewright for NT 


Codewright, the editor for programmers, is now shipping 
for Windows NT. Codewright supports a choice of standard 
key mappings (CUA, Brief, vi) as well as completely program¬ 
mable key mappings. The product offers multi-file search 
and replace, color syntax highlighting and change marking, 
language support for C, C++, Pascal, XBASE, and Paradox, con¬ 
figurable compiler and version control linkages, selective text 
display mode, hex-mode editing, text and file drag-and-drop, 
DDE support, and a DLL interface for extending the product 
Premia Corporation has also created Wizard Watcher, a 
Visual C++ add-on that monitors Visual C++ and sends mes¬ 
sages to either Visual C++ or Codewright to tell one applica¬ 
tion what the other is doing. For example, Wizard Watcher 
installs a button on Visual C++'s button bar that lets the user 


quickly call up Codewright with the same file, line, and 
column being viewed in Visual C++. Wizard Watcher is avail¬ 
able free to registered Codewright users via Premia's support 
BBS at (503) 646-1374, or in file cwwatc.ztp in the MSLANG 
forum on CompuServe. 

Codewright for Windows NT costs $249 for a single-user 
copy and $995 for a five-user license. Current Codewright 
users can buy a $99 license that lets them use the product 
on either Windows 3.1 or Windows NT, but not both. For 
more information, contact Premia Corporation, 1075 NW 
Murray Blvd., Suite 268, Portland, OR 97229, (503) 641- 
6000 or (800) 547-9902; FAX (503) 641-6001; CompuServe: 
70673,2627. 


Defect Control System Gets Security, Import/Export 


The Software Edge, Inc., has updated Defect Control Sys¬ 
tem, a Windows application for logging and monitoring 
software defect data. Defect Control System can guide users 
through defect entry and automatically notify team mem¬ 
bers of new bugs or updates. All changes are stored to 
preserve a complete audit trail. The product supports 
queries that classify bugs in relevant ways, including by 
status, severity, priority, owner, submitter, code module, etc 
You can generate trend reports to predirt release dates, 
detect troubled code modules, forecast customer failure 
rates, and identify the best test practices. 


Fastgraph Gets SVGA Support 

Ted Gruber Software has released Fastgraph v3.00, the 
latest version of their graphics library for programmers. The 
new version features SuperVGA support resolutions of 
640x400, 640x480, 800x600, and 1024x768 in 256 colors, and 
800x600 and 1024x768 in 16 colors. The library supports 18 
SVGA chipsets in addition to the VESA standard; program¬ 
mers can give precedence to the chipset-specific code or 
VESA functions. 

This version of Fastgraph offers new functions for display¬ 
ing and creating GIF files, adding to previous support for PCX 
and RLE file formats. The filled convex polygon is a fun¬ 
damental tool for 3D graphics, and this version includes new 


Data Widgets Provide Bound Controls for 

Data Widgets is a set of bound data controls for Visual 
Basic v3.0. The package includes: DataGrid, a bound data grid 
with full in-place editing; an Enhanced Data Control that adds 
the ability to scroll records backwards and forwards by incre¬ 
ments and the ability to flag a given record with a book¬ 
mark and return to it later with a single mouse click; 

DataCombo, whose edit and drop-down portions can be 


BugBuster Decodes Window Messages 

BugBuster is a new Windows tool designed to make 
debugging faster and easier. BugBuster decodes the status 
and notification messages that Windows generates while an 
application is running. Unlike tools such as Microsoft's Spy, 
BugBuster provides detailed text descriptions of the 
parameters associated with each Windows message. 

BugBuster decodes all Windows UM_ messages (including 
undocumented ones) and all DDE XTYP_xxx messages. The 
product lets you select messages or classes of messages to 
ignore or monitor. You can also enable or disable hex dump¬ 


Defect Control System v2.0 adds field level security, 
which lets an administrator control who can access and 
modify each defect field. You can define user classes that 
mirror individual tasks in the defect management process. 
The new version also supports import and export of data, let¬ 
ting you upload defect records from existing databases or 
transfer Defect Control System records into spreadsheets, 
databases, word processors, or graphics packages. 

Defect Control System v2.0 for Windows costs $695 for a 
single PC and $495 for each additional PC For more information, 
contact The Software Edge, Inc, 4420 haven Way, Colorado 
Springs, CO 80920, (719) 598-3713; FAXf719) 5 98-3970. 


functions to display such polygons, including clipped convex 
polygons. The polygon fill functions are as much as nine 
times faster than Fastgraph's general flood fill function. The 
product now includes a low-level keyboard handler that in¬ 
tercepts keystrokes ahead of the BIOS, a feature useful for in¬ 
creasing keyboard responsiveness for high-speed action 
games. 

Fastgraph v3.0 now consists of over 200 functions and 
costs $ 199; upgrades cost $69. A free evaluation kit is avail¬ 
able from the company's technical support BBS. For more in¬ 
formation, contact Ted Gruber Software, P.O. Box 13408, 

Las Vegas, NV 89112, (702) 735-1980; FAX (702) 735-4603; 
BBS (702) 796-7134. 

VB 3.0 

linked to separate data controls; DataOption, a 3D button 
that automatically synchronizes DataOption buttons within a 
common parent; DataButton, a 3D bound command button; 
and DataDropDown, which lets the programmer add bound 
lookup tables to any field. 

Data Widgets costs $129. For more information, contact 

Sheridan Software Systems, 65 Maxess Road, Melville, NY 
11747, (516) 753- 0985; FAX (516) 753-3661; BBS (516) 753-5452. 


ing of message parameters. Option settings can be stored for 
future use. The product supports auxiliary monitors or single¬ 
screen display with multiple output windows, choice of 
decoding the entire application or individual callback func¬ 
tions, automatic built-in logging of messages to a text file, 
and online and context-sensitive help. 

BugBuster vl.2 costs $69. For more information, contact 
Stone Age Software, Inc., P.O. Box 145, Herndon, VA 
22070-0145, phone/FAX (703) 742-9359. 
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Business Language Gets XBASE support 

JORF is an object-oriented language for DOS and Win¬ 
dows. The language can be interpreted during development 
and compiled for distribution. It features virtual memory and 
transparent database storage for structures, as well as auto¬ 
matic data typing for integers, floating point numbers, 
strings, text, structures, and arrays. 

JORF v2.1 adds support for XBASE .dbf, .dbt, and .ntx 
files, contains array handling, and supplies improved interna¬ 
tional date support The latest version of the interactive 
editor and debugger offers function highlighting, watch vari¬ 
ables, and an improved class browser. A new dynamic 
watch variable called an “auto-watch” displays the value of 
each assignment and conditional as you trace through the 


program. The debugger supports "rewind-change-continue” 
editing for on-the-fly changes to the source code. The v2.1 
Developer's Kit supports multi-module applications. You can 
overlay modules using Borland’s VROOM or another overlay 
linker. The jORF-to-C language translator contains new op¬ 
timizations. 

JORF v2.1 costs $85 for the Programmer’s Pack (includes 
DOS and Windows interpreters, editors, debuggers, sample 
programs, and a 300-page command reference guide), or 
$ 170 for the Developer's Kit, which includes the DOS and 
Windows compilers. For more information, contact The JORF 
Company, 25858 Elwood Road, Colton, OR 97017, (503) 
824-5673; FAX (503) 824-5255. 


IconDLG Handles Common Icon Tasks 

Sloop Software has released IconDLG Library, a library of 
icon-related functions for Windows 3.1 programmers. Library 
functions include: ChooselconO, which displays an icon 
browser dialog, a kind of GetOpenFileName() function for 
icons; ExtractlconDataf), which retrieves the specified icon 
resource data from .ico, .exe, or .dll files; Hakelconf), a 
function that creates and returns an icon handle from icon 
data obtained from ExtractlconDataO; CreateAlllconsO, 
which creates icon handles for all icons in a specific file; 
CreateCursorFromlcon () , to create a cursor from data 


returned by ExtractlconDataO; UritelconToICOf), which 
writes icon data to a . ico File; UritelconToBMPf), which 
writes icon data to a .bmp file; and ResizeObjectf), which 
resizes an icon to the specified height and width. 

IconDLG Library costs $150. A demonstration is available 
in file icndlg.zip on CompuServe in the WINSDK forum. For 
more information, contact Sloop Software, 6457 Mesedge 
Lane, Colorado Springs, CO 80919, (719) 260-0433, Compu¬ 
Serve: 72540,144, America Online: Sloop Soft. 


Fidex Offers Escrow Services 

One problem small software companies face is 
credibility: what happens to the product if the company 
goes out of business, or loses its key programmer? Clients 
(especially state and federal agencies) may ask for source 
code in order to compensate for this risk, but developers 
may be reluctant to distribute source for a variety of valid 
reasons. 

Fidex Americas Corporation offers a solution to this prob¬ 
lem. Their new Software Security Service lets a developer 


place source code in escrow, under a written agreement be¬ 
tween the developer and the client This agreement 
specifies what events trigger the release of the source code 
to the client. This arrangement protects the security of the 
source code, but addresses the legitimate interest of the 
client. 

For more information, contact Fidex Americas Corpora¬ 
tion, 821 Fir Street, Sandpoint, ID 83864, (800) 569-7569; 
FAX (208) 265-4191. 


B-Tree Filer Moves to C/C++ 


B-Tree Filer is a function library for creating network- 
compatible databases that had formerly been available only 
for Turbo Pascal. TurboPower has now released a version for 
C that supports Borland C++ 3.0, Turbo C++ 3.0, Visual C++, 
and Microsoft C++ v7.0. The package supports variable-length 
records, up to 100 indexes per index file, and precise control 
of indexes, locking, and memory usage. The library is com¬ 
patible with Novell, Lantastic, MS-Net, Vines, and any net¬ 
work that supports DOS 3.x locking calls. B-Tree Filer for C 
includes browsers for multiple frameworks and network- 


specific modules that let applications take advantage of 
multi-user capabilities. 

B-Tree Filer for C costs $249 for the network version, 
$189 for a single-user version. The package includes full 
source code, documentation, popup help, example and 
demo programs, and free support by telephone, FAX, and 
CompuServe. For more information, contact TurboPower 
Software, P.O. Box 49009, Colorado Springs, CO 80949- 
9009, (719) 260-6641; FAX (719) 260-7151. 


Toolkit Handles QuickTime and AVI Movies 


The Canyon Movie Toolkit is a new C++ class library that 
lets Windows 3.1 programmers create programs that read 
and write QuickTime for Windows and AVI movies. You can 
use the toolkit to edit these movies by reading an existing 
movie and writing out a new one. You have to make sure 
that the proper codecs (compressor/decompressor) are avail¬ 
able at playback time. Currently, the only codecs available 
for both AVI and QuickTime are CinePak (Compart Video), 
from SuperMac, and Intel's Indeo. 


The Canyon Movie Toolkit costs $799 for libraries for 
either Visual C++ or Borland C++ v3.1; source code costs an 
additional $799. The package includes a sample Windows 
program that converts AVI movies to QuickTime for Win¬ 
dows movies and vice versa. For more information, contact 
The San Francisco Canyon Company, Inc., 150 Post Street, 
Suite 620, San Francisco, CA 94108, (415) 398-9957; FAX 
(415)398-5998. 
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Readers' Forum 


Dear Editor! 

I'm a subscriber of W/DDJ for about nine months and I 
enjoy it very much. 

In the August issue of W/DDJ (page 23+) James K. Lawless 
presents some methods of making more memory available 
under DOS. His article gives a nice overview but is very short 
in details. I think there is some important information missing: 
he describes how to allocate memory in HMA via D- 
OSHMASSubAlloc(), but there is nothing about how to release 
it (as well-behaved programs should do). Can anybody give a 
hint? 

The need of releasing allocated memory is completely ig¬ 
nored in his example realmem.c. By the way, the line 

printf ("%u bytes are availableW); 

in his routine HMATest() (page 24) should read: 

printf ("%u bytes are available\n", wWork); 

Thanks for your practical magazine, 

Ruediger Kloeckner 
Pfarrfeld 10 
D-57234 Wilnsdorf, Germany 

A very good question; I wish I had as good an answer. 
James says that, as far as he knows, DOS doesn’t provide 
any matching function for freeing up HMA memory that you 
allocate via the undocumented INT 2Fh, function 4A02h call. 
I also double-checked this with Andrew Schulman, who was 
busily working on the galleys for the second edition of Un¬ 
documented DOS at the time. The new edition covers more 
ground than the first edition, but as far as everyone knows, 
there is no deallocation call for this suballocated HMA 
memory. Since this interface is undocumented, perhaps 
Microsoft simply had no need internally to ever free up the 
suballocated HMA memory. If anyone out there believes 
they know differently, please let us know. Thanks for point¬ 
ing out that printf() mistake! -rib 


Dear Ron, 

You certainly remained faithful to your column title “Practi¬ 
cal” and it’s great. I get paid to manage and program C. My 
C++ experience has been entirely on my own and I am very 
familiar with that lost feeling of trying to apply newly-learned 
concepts to my own problems. 

I recently stumbled when trying to create a set of class 
libraries which used virtual tables. My problems arose when I 


switched memory models for my main program but had not 
recompiled my libraries to use far access to the virtual tables 
(in the data segment). I solved my immediate problems, but I 
didn’t develop an overall strategy for creating class libraries 
with regard to memory models and efficiency. I would love to 
see a column address class library development taking into 
account all those real life issues that arise. I am currently 
using Borland C++ and I have enclosed copies of the User’s 
Guide to show what kind of options they support. I would be 
interested in knowing what features other compilers offer. 

I work on satellite flight software which involves em¬ 
bedded processors. I realize your column addresses Windows 
and DOS programmers, but a deviation to address embedded 
C++ issues would certainly be appreciated. I look forward to 
your next column. 

Sincerely, 

Dave McComas 
15634 Thistle Downs Ct. 

Woodbine, MD 21797 

That would be a good topic, but probably outside our 
focus. Do you receive Embedded Systems Programming? 
Although I had to tell some rather prodigious lies to get my 
free subscription, I really like their magazine. They have 
some pretty serious writing talent, like P.J. Plauger (the 
editor of The C User’s Journal), and they seem to be doing 
more C+ + pieces of late. 

I do expect to cover some issues related to different 
vendors’ Windows compilers. One thing that makes my life 
much easier is that I absolutely, positively refuse to use any¬ 
thing but the large memory model for Windows C+ + 
development. I realize that not everyone has that luxury, but I 
suspect that a lot of people suffer with other models to ob¬ 
tain an increase in efficiency that is barely perceptible to the 
end user. With Win32s here and compilers (well, at least 
Symantec C++) to take advantage of it, I’ll switch to 32-bit 
code for speed long before I’ll go back to having code that 
dies because I forgot to put an LPSTR cast on an argument 
to wsprintf(). Thanks for the compliment and suggestions! 
-rib 


Ron, 

In the August 1993 issue of Windows/DOS Developer’s Jour¬ 
nal there was an article entitled "Visual Implementation: 
Grouped Menu Items.” We are presently building a C++ ap¬ 
plication in Windows and decided to use this for those instan¬ 
ces where it would apply. 
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To do this, however, I needed to make a slight modification 
by adding a fifth parameter called uFlags to the function 
definition (and prototype). This is as follows: 

void FAR PASCAL CheckMenuGroup(HMENl) hMenu, int idFirst, 
int idLast, intidCheck, UINT uFlags); 

I did this so this code could be used for popup menus as well 
(which have no IDs associated with them and require using 
the menu position). I also changed the two commands in the 
for loop to look as follows: 

SetMenuItemBitmaps(hMenu, c, uFlags, NULL, hBmp; 
CheckMenuItem(hMenu, c, uFlags | 

(c = idCheck) ? MF_CHECKED : MFJJNCHECKED); 

After removing the existing code (which used checkmarks) and 
adding this code, I found that it worked for the calls in which 
uFlags was set to MF_BYCOMMAND (as is hard-coded in the ar¬ 
ticle). However, CheckMenuItem() failed every time uFlags 
was set to MF_BYP0SITI0N. Upon further investigation, the 
CheckMenuItem() call turned out to have an operator 


precedence problem. Because the binary OR operator (|) is of 
a higher precedence than the ternary operator (?), the follow¬ 
ing is actually what occurred: 

CheckMenuItemfhMenu, c, (uFlags | (c = idCheck)) ? 

MF_CHECKED : MF_UNCHECKED); 

In other words, the comparison took place first (as expected) 
returning TRUE or FALSE (1 or 0). Then, it was 0/?ing that value 
to uFlags and if the result was not 0, it would return 
MF_CHECKED. Otherwise, it would return MF_UNCHECKED. In the 
article, the code worked correctly only because MF_BYC0MMAND 
is set to 0x0000 in windows.h. Therefore, the code for Check- 
Menultem() received what it believed to be MF_BYC0M- 
MAND\MFCHECKED (or MF_UNCHECKED) and it handled everything 
correctly. However, when MF_BYP0SITI0N (0x400) was passed 
in, the results also returned what CheckMenuItem() believed 
to be MF_BYC0MMAND\MF_CHECKED (or MF_UNCHECKED) and not 
MF_BYP0SITI0N\MF_CHECKED (or MF_UNCHECKED). This gave in¬ 
correct results as it tried searching its resources for a menu 
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• Easily reorganize topics, subjects, 
keywords 

• Uses Microsoft Help Compiler 

Single User: $89.95 

MC & Visa accepted, Shipping additional 

Call: IMCSI (212)319-1903 

425 Madison Ave., New York, NY 10017 
□ Request 223 on Reader Service Card □ 
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Access Windows 
Master Environment! 


WinPath-vl.O provides previously 
unavailable path and environment 
variable management functions 
directly from within Windows. 
Visual Interface, command 
language, DDE and command line 
control. Affects all Windows tasks 
and DOS sessions. Simple path 
modification and editing. Extends 
path beyond the DOS 127 byte 
limit. WinPath is the logical 
extension of the DOS PATH and SET 
commands for Windows. 

icicfcfrick Anchor Software, Inc. 

P.O. Box 124 
. . Cheswick, PA 15024 


Tel.(412)274-6504 Fax:(412)274-5010 
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WE FUND 

SOFTWARE DEVELOPERS 

Are you an independant contractor 
or a small company with a product 
under development? 

Are you an engineer who has the 
talent to develop commercial 
software? 

WE CAN SUPPLY FUNDING, 
CONCEPTS, DESIGN, 
PLACEMENT, AND/OR 
ENGINEERING. 

SVI, Software Ventures 
International, has successfully 
developed and funded over 50 
software products with over 10 
million units sold worldwide. 

FAX 808-823-0505 


AT LAST! 

SOURCE CODE ESCROW 
DESIGNED FOR YOU! 


It’s finally here — A source code escrow 
service for independent developers. Simply 
deposit a copy of your source code with 
Fidex Americas, along with instructions 
detailing when to release the code to your 
client. You retain copyright. 

• Guarantee future support 

• Enhance your professional image 

• Overcome sales resistance 

• Limit your liability 

• Clients pay cost! 

Call today for complete informationl 

FIDEX 

AMERICAS 

CORPORATION 

821 Fir Street • Sandpoint, ID 83864 
1.800.569.7569 • FAX 208.265-4191 
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Macro Toolkit 



Is your Windows program part of a 
''solution''? It is with our common macro 
scripting language tool kit. You will 
automate apps, networks, whole systems. 

Build it into your Windows program in a 
morning. Onr price is reasonable. Our 
complete evaluation kit is just $20.00 

Call 1-800-762-8383 or 206-938-1740 
Wilson WindowWare 
2701 California Av. SW, Suite 212 
Seattle WA 98116 U.S.A 


□ Request 227 on Reader Service Card □ 
Windows/DOS Developer’s Journal — Page 83 












































item with an invalid ID rather than searching by its position. 
The correct code for this line should be: 

CheckMenuItem(hMenu, c, uFlags | 

((c = idCheck) ? MF_CHECKED : MF_UNCHECKED)); 

Please notice the added parentheses around the comparison 
statement. 

Thank you! 

L. Brad Eck 
11857 44th Place South 
Seattle, WA 98178 

I was totally confused by your statement that popup 
menus “have no IDs associated with them". As far as I know 
menus are menus (even if you pass them to TrackPopup- 
Menu()) and they all have IDs associated with them. Maybe 
you meant that your particular project needs to use menu 
positions rather than IDs for some reason. 


The conditional operator bug is a classic one — thanks 
for catching it. We already try to run BoundsChecker for 
Windows against the code in the magazine, and I’m on the 
lookout for further automatic methods of detecting problems. 
Maybe I should look at some products that do test coverage 
analysis, which might have warned me that that branch of 
the code never got exercised and made me look at it close¬ 
ly. Any readers out there with product recommendations? 
—rib 


Dear Ron, 

You asked for feedback concerning your “Practical C++" 
column in Windows/DOS Developer’s Journal, so here i go: 

The name of the magazine is Windows/DOS Developers 
Journal — not C++ Programmers Journal or (sic) Computer Lan¬ 
guages. I think you should cling to your title, there are enough 
other resources for all those who want to dive deeply into the 
idiosyncrasies of C++. 

Sure enough, many programmers have to or want to pro¬ 
gram in C/C++. This leads to the sad fact that most of the 
sample programs you publish are written in C or C++. (1 think 
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BRIDG IT™ 

Your Windows & DOS - dBConnection 



Bridgit is a full featured database engine that provides 
easy to use functions for creating, reading, updating 
and indexing dBase-ill-*- and Clipper files. 

With Bridgit you create your application only once...then 
convert it to Windows or DOS using either dBase-lll+ or 
Clipper files. 

Order the ultimate database engine for Visual Basic 
and Visual C++ for just $69.95. 


Unelko Corporation 

Tel:(602) 991-7272 • Fax:(602) 483-7674 
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Squash those bugs... 
with BugBuster™ for Windows 


Now you can 
"BugBust” your 
software for cleaner, 
healthier apps. Our 
revolutionary new 
product will decode 
those mysterious 
WM xxxx and 
DDE messages that 
Windows sends to 
your apps. You'll 
get instant text 
descriptions instead 
of cryptic hex 
mumbo-jumbo. 


You'll be up and 
running instantly 
with BugBuster. It's 
powerful. It's quick. 
It’s easy to install 
and simple to use. 
You can even custom 
tailor and save your 
personal debugging 
options. 

Order now to save 
time and get better 
performance from 
your Windows apps. 



Send $69 check or money order to: 
STONE AGE SOFTWARE 
P.O. Box 145 
Herndon, VA 22070-0145 

VA residents add sales tax 

Outside US & Canada add $20 for shipping 
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MULTI-PLATFORM CD ROMS 


GRAPHICS 1 CD ROM $24.95 

HUNDREDS of Graphic programs & Utilities w/ source 
& sample data. Animation, drawing & Paint, converters, 
fractals, JPEG, mapping, plotting, ray tracing, etc. Full 
description of all popular graphic file formats. 16,000 
FILES, 426 MB 

AUDIO 1 CD ROM $24.95 

More than 1400 sample sounds & MOD files PLUS 
Hundreds of audio programs and utilities w/ source. 
Converters, editors, generators, players, samplers, 
speech, trackers, etc. 

LANGUAGE / OS CD ROM $39.95 
The LARGEST collection of source & executables for 
compilers, interpreters, function libraries, and 
documentations for standard and research computer 
languages and operating systems ever assembled, > 649 
MB. Includes Ada, Basic, C, C++, E, E++, Forth, Lisp, 
Mach, Modula, Oberon, Pascal, Prolog, Rexx, Scheme, 
Simula, TCL, etc. 

KNOWLEDGE MEDIA Inc. 

434 Nunneky, Suite B, Paradise, CA 95969 USA 
1-BOO-78 CD ROM - VISA/MC/COD 
+1-916-872-3826 Voice/FAX 
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Architect for Windows 


Windows Installation disks for your applications 
are only one mouse click away. No scripts or file 
lists! No programming! 

Architect™ does all the work. 

Standard Features; 

Creates install disks automatically 
Creates complete directory trees 
Copies normal and compressed files 
Builds program groups and Items 
Progress Indicators 

Standard Edition: $ 49.95 

Professional Edition: $ 129.95 

(plus $6.00 S&H) 


Synapsys 
l Software 


~ 1 1 1 303-2209022 

8400 East Prentice, Penthouse 
Englewood, Colorado 80111 
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Network Toolkit 


This kit provides an abstract programming layer 
for developing network applications that are 
independent of the underlying network protocol. 
Developers write one application that will run 
over NetBIOS, IPX or Windows Sockets 
transparently without having to master the API 
set for each of the protocols. All network services 
are event-driven with both connection-oriented 
and connectionless circuits supported. US$495. 

Interfaces: 

Visual Basic™ custom control (VBX) 
Microsoft® or Borland® C/C++ 

Borland Pascal 

Intelec Systems 

10201 W. Markham, Ste. 101 
Little Rock, Arkansas 72205 
Fax 501.221.7412 
501.221.3600 
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SmartHeap is an ANSI portable maHoc 
and new for DOS, Windows, NT, OS/2, 
UNIX and other platforms. Proprietary 
alsorithms deliver speed improvements 
up to 100X versus other commercial 
mallocs, especially for large heaps in the 
presence of virtual memory. SmartHeap 
localizes data structures in their own 
heaps. Plus it includes numerous fixed- 
size and handle-based APIs. Debugging 
facilities isolate leakage, overwrites, 
double-freeing, wild pointers, and many 
other errors to responsible file/line/pass 
count. Exceptionally reliable - used by 
a “who's who" of commercial software 
publishers. No royalties. Source avail¬ 
able. 

CALL FOR FREE 

WHITE PAPER, BENCHMARKS, 
AND ERROR REPORTS 


MicroQuill 


Software Publishing, Inc. 

800-441-7822 / 206-525-8218 
FAX 206-525-8309 

CompuServe: 70751,2443 
Internet: devtools@microquill.win.net 


Phone Sound: Simple! 

For Windows/DOS Voice Mail & Fax Developers 


Professional 
Tools for 
your Voice 
Mail, Fax & 
Audiotex 
Applications 


1. Create fantastic prompts Multimedia Wave (16, S & 

and save time with MS ADPCM), linear 16 & 

VFEdit®\ Record, crop, cut, unsigned 8, plus Dialogic 4 
copy, paste, mix, fade, echo, & 8 at any sample rate! 
volume & more with your 4. Scribe Transcription 
Dialogic™ D4x/12x boards. Utility for DOS plays digital 

2. Add Voice Mail power to audio files in the background 

your MS Windows apps with without voice mail hardware! 
TI/F DLL ™, our Tel I/F 5. Add Text-to-Speech 
Dynamic Link Library. capability to your apps with 

3. Audio ToolBox™ VoxFonts™, our "software 

converts to and from _ only" text-to-speech library! 


Order Now: 1-800-234-VISI 


[ Voice Information Systems: 24 N Merion Ave, Bryn Mawr, Pa 19010 I 
Tel: 215-747-5035/BBS: 215-747-3062/Fax: j-800-234-FXlT ]i 
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SDLC, BSC, HDLC, 
X.25 ON THE PC 

Use the Sangoma SDLA card to 
provide link support for your product 
that is cost effective, full featured, rock 
solid and easy to use. 

• Line speed to 180kbps 

• Operating statistics and built in 
datascope make your product easy 
to configure and debug 

• Menu driven test program included 

• Primary and secondary SDLC with 
multiple addresses 

• HDLC LAPB, LAPD, NRM mode 

• CCITT 1988 X.25 implementation 

• High level interfaces under DOS, 
Unix, Windows, OS/2 

SANGOMA Technologies Inc. 

Tel: (416) 474-1990; (800) 388-2475 
FAX: (416) 474-9223 


1 - 

I Does your company 
provide tools, products, 
or services for advanced 
Windows programmers? 
Then reach over 22,000 
serious programmers in: 

Windows/POS 

□ DEVELOPER'S JOURNAL 

Call 913-841 >1631 today for 

information about 
advertising opportunities in 

Windows/DOS Developer’s Journal. 

Advanced. Serious. 

Technical. 


I Brian Osborn - Continental Europe. 

+49 431-396895 

I Ed - East I Donna - Midwest I Edwin - West 
913 - 841-1622 1913 - 841-6733 1913 - 841-1626 


NETWORK 

CONTROL 

LIBRARIES 

NETBIOS ROUTINES allows ac¬ 
cess to low-level network func¬ 
tions. Name, session, and 
datagram routines. Wait and no¬ 
wait options. $99 

NETBIOS DLL for Windows $199 

NETWORK MASTER provides 
access to Netware internal func¬ 
tions. Complete network control 
from your compiled programs! $99 

Starlight Software 

P.O. Box 1090 

Wheeling, IL 60090 

(708) 394-0622 _ 
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C and C++ DOCUMENTATION 


! AUTOMATED DOCUMENTATION ! 

• C-CALL ($69) Graphic-tree of caller/called 
functions, cross-ref, file/function index. 

• C-CMT ($69) Creates/inserts/updates 
comment-blocks for each function, listing 
the functions and identifiers used by it. 

• C-METRIC ($59)Counts path complexity, 
counts comments, code, 'C statements. 

• C-LIST ($69) Lists and action-diagrams, 
or reformats into standard formats. 

• C-REF ($59) Creates cross-reference of 
local/global/define/parameter identifiers. 

• SPECIAL : C-DOC ($199) All 5 Droarams 
integrated as DOS program (<15,000 lines) 

• NEW! C-DOC Professional ($299) 

DOS, OS/2, Windows. 3-rina binder/case. 
Processes 150,000 lines, deterred reports. 

« 30-DAY Money-back guarantee CALL NOW 

SOFTWARE BLACKSMITHS INC. 

6064 St Ives Way, Mississauga 

ONT, Canada Voice/Fax (4161-858-4466 

L5N-4M1 Demos/BBS ?416)-858-TgT6 


see AD INDEX for our larger ad 
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VB/ISAM™ 

CB/ISAM™ 


FAST, CLEAN, AND EASY 
serious data management 
for Visual Basic ” and C, 
both Windows™ and DOS. 

For professional applications since 8/91: 
VARIABLE-LENGTH fields and multi-format 
records to 64K, SUPER-FAST and reliable 
with files to 512 MB. Automatically 
maintains up to 80 indexes: small, friendly 
API, 50KB DLL. Special offer: multi-user 
$169.95, single-user $99.95. No royalties. 

Software Source 

42808 Christy Street, Ste. 222 
Fremont, California 94538 
Tel. (510) 623-7854 • Fax (510) 651-6039 


JOBS 

PM 
Mac 
Oracle 
Progress 
Windows NT 
Smalltalk 
Case 
OS/2 

Our midwest Clients qre using 
Leoding edge technology you thought 
you'd only see on the coasts. Discover the 
heartland, our qualify of life and our 
commitment to technology. 

Employer Paid fees only. 

All recruiters are certified by the NAPC. 

Brad Moore, C.P.C. 

256 N. 115th Street, Suite 1, Omaha, NE 68154-2521 
(402) 334-7255 Fax (402) 334-7148 
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eXAminATOR 


Simulation of the Microsoft? Windows™ Certified Professional Examinations 


Enhance your value to clients, peers and employers 
using Examinator, an interactive Windows 3.1 pro¬ 
gram that helps you prepare for and pass the Micro¬ 
soft Windows certification exams given at authorized 
testing centers worldwide. 

• Four complete simulated exams 

• Exam registration instructions and study outlines 

Benefits of this credential include a license to use 
the Microsoft Windows logo, a wall certificate, 
membership card, MCP directory listing and more! 
*89 + $ 4 s&h To order, call (615) 327-1858 
VISA/MC/Check/MO/COD fax (615) 320-6594 



Transcender™ 

Dept. □ Corporation 

242 Louise Ave. 

Nashville. TN 37203 
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that the convulsions you had to go through to create a simple 
C++ file object justify once again the usage of the attribute 
“sad'’ <grin>.) But this doesn’t matter as long as the samples 
teach us something about "Windows/DOS Developing’’ instead 
of something about a specific language. It's normally no prob¬ 
lem to adapt these samples to a different language. (Well, at 
least as long as you keep away from those weird “features’’ 
like multiple inheritance ...) 

So please keep on doing the good job you did before: To 
help us to program for Windows and DOS more effectively — 
in whatever language we are lucky or unlucky enough to use. 

Manfred Keul 
CompuServe: [100031,12] 

I'm afraid I have to agree with your criticism of the first 
installment of my column. It is important for us to keep our 
focus, something we’ve worked hard to achieve and some¬ 
thing that helps distinguish us from our competitors. After 
the first installment, the column takes a turn for more Win¬ 


dows-specific topics, although I am still interested in dis¬ 
cussing C++ programming issues in the context of Win¬ 
dows programming. 

I don't quite agree that language-specific issues lie out¬ 
side our domain. The modern versions of FORTRAN, Pascal, 
and C, are pretty interchangeable in my mind when it comes 
to the ability to express a design. Languages like C+ + and 
Object Pascal are a significant step up in complexity and 
expressive power, though. The lowest common denominator 
of C and C++ is simply C, and I am not always willing to 
give up the ability to exploit object-oriented solutions to Win¬ 
dows problems in order to make the code more accessible. 
As in the past, some of our articles will focus on general 
Windows and DOS programming techniques that are lan¬ 
guage-independent, and some will focus on solutions to lan¬ 
guage-specific problems. The challenge is always to strike 
the right balance so that all our readers find value in every 
issue. Thanks for the well-reasoned criticism, —rib 
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SVInstal 

Version 2.0 


Installs anything... 

You just run the install builder, telling it your 
company name, application name, default 
directory, disk space required and list of files. 

No programming or scripts to write. 

What SVInstal does... 

♦ Creates destination directories, copies files. 

♦ Makes program group, puts in your icons. 

Features... 

Progress gauges, multiple source disks, directory 
trees, file compression, network server/client or 
standalone. No royalties! 

Soft Ventures (dept. WDJ) OC 

Box 22183 Bankers Hall V* V^US 

Calgary Alberta Canada (plus $5.00 s&h) 

T2P4J5 (403)278-1681 Canadian $69.95 + 7% GST 


□ Request 194 on Reader Service Card □ 


TLIB m is FASTEST! 



RCS™ 4.2 PVCS 1 " TUB™ 3.0 TUB™ 5.0 


Times are to update a 45K library on a PC/XT. PVCS and TUB 3.0 are 
from Sept 87 PC Tech Journal. MKS RCS 4.2 and TUB 5.0 are newer. 


TUB™ is BEST! 


“Do not he fooled by the fact that this is the 
least expensive of the five packages reviewed 
here - TUB has features and power to spare" 
John Rex, Computer Language 
“TUB is a great system" J. Vallino, PC Tech J 


• Full-Featured Version Control for Software 
Professionals. Check-in/out locking. Branching. 
Keywords. Wildcard and list-of-file support. Can 
merge parallel changes and undo intermediate 
revisions. Network and WORM support. Main¬ 
frame compatible deltas for Pansophic, ADR, IBM, 
etc.. Integrates with Opus™ MAKE & Slick™ MAKE. 

MS-DOS $139, OS/2 $195 + shipping Visa/MC 
5 station LAN license $419 (OS/2 $595), call for other sizes 

BURTON SYSTEMS SOFTWARE 

PO Box 4156, Cary, NC 27519 (919)233-8128 
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Tools for Novell's Btrieve® 


Bsupport III Bsupport II 

Bcdit 3.0 - Btrieve Hie viewer/editor. 
Banalyze 2.0 - Btrieve app. debugger. 

Brun 2.2 - BUTIL replacement plus source. 
Bcreate 2.0 - file creation utility. 

Bcheck 2.0 - Btrieve file analyzer. 

Xsupport 1.0 - build data dictionary 
(.DDF) for Access, OV, 
Crystal Rpts. 

Xport 2.0 - export/import CDF, SDF, 
dBASE. 

Call for information on additional 
products and FREE demo! 

Information Architects, Inc. p| i; (goo) 359-2721 
.3130 Pine Tree Road (517) 887-8000 

Lansing, MI 48911 Kax: (517) 887-2346 
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1 LINKER HEADACHES 


OPTLINK for Windows offers 
Borland-based developers with 
33% faster linking, 33% smaller 
programs, and fully supports 
Turbo Debuger. Links Visual C++ 
programs 50% faster too! 

SLR Systems, Inc. 

(412) 282-0864 • Fax: (412) 282-7965 
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We Understand The 
Programmer's Mind 

When the country's top firms look for the 
best developers available, they turn to 
Bateman. Why? Because we specialize in 
Microsoft Windows, NT, OS/2 and Macin¬ 
tosh recruiting nationwide. So if it's time for 
a career move, give us a call. We under¬ 
stand your skills, and the marketplace for 
them... we understand you. 

E Bateman Inc. 

5847A Uplander Way 
Culver City, CA 90230 
Tel: 310-641-4100 Fax: 310-64 1 -2900 
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GCP++ is the 
development 
solution for 
TCP/IP under 
Windows! 

Encapsulates TCP, UDP, TELNET & TFTP in a 
robust and easy-to-use server, so you start 
with proven socket library code! 

Genisys Comm Pack++ 

• OLTP, emulators, DBMS, all client/server apps • 
• VB Custom Control and DLL interfaces • 

• Low-cost stack option for integrators • 

Download the GCP++ Evaluation Kit today! 

a GENISYS Comm, Inc. 

314 S Jay St, Rome, NY 13440 

MfiKKEr 315-339-5502 • fax 5528 
WlNIXWb'u 

COMIW1BLE GCP-H-@GENISYS.com 
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SpyWorks-VB 

For Visual Basic™ - Windows 

SpyWorks-VB allows you to do virtually 
anything in Visual Basic that is possible 
using other languages such as C. It 
includes controls that easily subclass 
VB forms and controls, detect keyboard 
events, and support callback functions. 
SpyWorks includes debugging tools to 
view message and event history, detect 
API parameter errors, Browse Windows 
memory and resources, and retrieve 
information about any window, form or 
control in the system. 

SpyWorks-VB is only $129 + $5 s&h ($15 
outside U.S & Canada). Visa/MC orders 
include phone and exp. date. CA residents 
add 8.25% sales tax. Dual media - Requires 
VB2.0 

Desaw are 

5 Town & Country Village #790 

San Jose, CA 95128 

(408) 377-4770 fax:(408) 371-3530 
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Career Marketing Associates 

7100 East Belleview Avenue. Suite 102 
Englewood, CO 80111 

Today, 1993 

Dear WINDOWS DEVELOPER: 

Do you know where the best 
Windows development jobs are? I spend 
my time looking for strong 
opportunities for Windows developers 
and software engineers. I might be 
looking for someone with your 
qualifications right now. And there you 
sit in the corner reading a magazine! 
Pay attention, this is your future we 
are talking about. Currently I have 
multiple jobs requiring Windows 
experience, C++, or GUT. If you are 
thinking about a career change, 
shouldn’t you be working with a 
specialist? All fees are paid by the 
company. Write, call, fax, or 
communicate by smoke signals, I’my 
waiting to hear from you. / 


Sincerely, 



Gary Patton 
303-779-8890 
FAX 303-779-8139 



( ; 'n 

Windows 

Developer Jobs 

Specialists in jobs for software 
engineers in leading edge technology. 
Windows, PM, GUI, Languages, AI, 

Mac, CASE, Video, Realtime. 

Nationwide contacts with both large 
and small companies including equity 
startups. Many of our clients develop 
and publish commercial software 
products. Managed by graduate 
engineers. Never a fee to an 
applicant. 

1-800-231-5920 
Scientific Placement, Inc. 

SPI-8, Box 19949, Houston, TX 77224 (713) 496-6100 
SP1-8, Box 71, San Ramon, CA 94583 (510) 733-6168 
SPI-8, Box 4270, Johnson City, TN 37602 (615) 854-9444 
Fax: 713-496-6802 please use Fine Setting on Fax 
Email: Ascii preferred: Internet LSH@Scientific.com; 
Vcompuserve: 71250,3001; Genie: D.SMALL6 
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COM1: - COM4: WITH WINDOWSI 

1,2, OR 4 PORT RS-232 BOARDS 
RS-232 AND RS-422 VERSIONS 
XT AND AT INTERRUPT JUMPERS 
OTHER PRODUCTS INCLUDING LAPTOP 
ADD-ONS 

DELIVERY FROM STOCK. 

MADE IN USA 

EXCELLENT TECHNICAL SUPPORT 


SEALEVELSYSTEMSINC. 
P0 00X830 
LIBERTY.SC29657 

803-343-4343 


,5EflLEVEL 
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Opt-Tech Sort/Merge 


New - Version 5 

High performance Sort/Merge/Select 
utility. Run as a stand alone 
utility or CALL as a subroutine. 

Supports most languages and 
filetypes including Btrieve 
and dBase. Unlimited filesizes 
multiple keys and much more. 

MS-DOS, Windows $149 
OS/2, UNIX $249 

Call to order or for free info. 


Opt-Tech Data Processing 
P.O. Box 678 
Zephyr Cove, NV 89448 

. (702) 588-3737 > 
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CDROMs for Work and Play! 


Giga Games CDROM $39.95* 

Over 2700 Games for Microsoft Windows and 
MSDOS. 250 Megs of games plus 150 Megs of 
source. Lots of educational games. July 1993. 

CICA MS Windows CDROM $24.95* 

2518 files of MS Windows programs. Utilities, 
games, source code, programming tools, fonts, 
drivers, icons. April 1993. 



Simtel MSDOS CDROM $24.95* 

650 Megabytes, 9000+ files.Programming tools, 
utilities, editors, education, source 
code and more. May 1993. 

* Shareware programs 
require separate payment 
to authors if found useful. 

1-800-786-9907 orders@cdrom.com 
FAX 1-510-674-0821 

$5 S&H per order (USA Canada Mexico) 

$10 overseas 1 -510-674-0783 AMEX/VISA/MC/COD 
***** All our disks are 

unconditionally guaranteed. 

Walnut Creek CDROM 

4041 Pike Lane, Suite D-699 
Concord, CA 94520 
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ABSOLUTELY, 

POSITIVELY, 

NO MORE 

V-ls T iHC. 
E B ft OR S/ 


$5/disk, 

one issue per disk 
or ALL of 1992 
or 1991 for $20! 

Call today! 

913 - 841-1631 

FAX 913-841-2624 


Windows/POS 

□ DEVELOPER'S JOURNAL 

Suite 200 

1601 West 23rd Street 
Lawrence, KS 66046 


2 ™ 

The Art of Visual Basic Programming ™ 

This amazing new book by J. D, Evans, Jr. unlocks 
the secrets of Windows and Visual Basic 
application design and programming. It explains 
Windows design from a unique and easy to 
understand perspective. Smart Objects, Hybrid 
Objects, Control Coupling, Events, Focus, Event 
Triggering, Visibility, Form and Module Code 
Placement, DLL Parameter Passing, Variable 
Scope, Strings, and Structures are described and 
explained. Enlightening allegories and annecdotes 
make this one of the most unusual and informative 
Windows books ever written. This book is the 
Rosetta stone for Windows and Visual Basic! 


Book: $29.95 Companion Disk: $9.95 

ETN Corporation 

RD4 Box 659 Montoursville, PA 17754-9433 
(717) 435-2202 (Sales) (717) 435-2802 (FAX) 
AMEX/MC/VISA/Check/MO/PO/COD 
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They’re all here. All the tools, tips and techniques you need 
to send your OS/2® development rocketing up the charts. 
Brought to you by the original artists: IBM’s own OS/2 develop¬ 
ment team. 

Join The Developer Connection for OS/27 
and you’ll receive the most timely and extensive 
information available to the OS/2 community. 
Four times a year, you’ll get a CD packed with the 
latest productivity tools, utilities and sample programs 
from IBM and others. A powerful browser and easy, 
user interface let you locate any topic instantly in our com¬ 
prehensive technical library. 

Each CD includes the latest releases of smashes like 
“The Developer’s Toolkit for OS/2,” “Multimedia Presenta¬ 
tion Manager/2 Toolkit,” and “Pen for OS/2 
Toolkit.” Plus, you also get pre-release 
versions of many IBM products, operating sys¬ 
tems, internal development tools, product demos, 
bit maps—you name it. 

But wait, there’s more. You also receive 


test 


The Developer Connection News, our newsletter filled with 
information about the latest OS/2 developments, new products, 
a Q&A column and much more. Plus, you get access to the Developer 
Connection forum on CompuServe7* where you can talk directly to 
the experts. 

And here’s music to your ears: Buy a year’s subscription to The 
Developer Connection for OS/2 
before November 30,1993 and pay 
only $149—a savings of $50 off the 
regular rate. Call 1 800 6DEVCON 
today, and start producing some 
hits of your own. 


Buy a year’s subscription to The 

hits. 


Operate at a higher levels 


•CompuServe membership is required. IBM and OS/2 are registered trademarks and The Developer Connection for OS/2 
and "Operate at a higher level" are trademarks of International Business Machines Corporation. CompuServe is a 
trademark of CompuServe Incorporated. ©1993 IBM Corp. 
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VOID EMBARRASSMENT! 


“A customer found a bug in | 
our software with a tool ~ 
called BOUNDS-CHECKER ... I 

Why aren't we using 

BOUNDS-CHECKER?” 


Use BOUNDS-CHECKER™ V2.0 For Windows , The Automatic Bug Finder! 




2 is invalid - GDI OBJICT: 0000 




♦ fietums |* Win Msgsj ♦ filg Msgs 1 ♦ flutstr 1 * J,ogEnor j find' 


>XMtT: L0CAH0CK rituns: 3ADA 
>ICALL: CRSATEPALETTE (PTR:1017:3ADA) 
>IB»T: CRBATBPALBTTK return*: 0000 


BCHKW 


Whether you're the boss, the QA Manager orthe programmer, it'syour responsibility to ensure that 
your company's Windows programs are "bug-free" before they get into the hands of customers. 
If you're developing under C or C++, producing a "bug-free" Windows product is no longer a long 
and stressful experience. 

Announcing BOUNDS-CHECKER V2.0 For 
Windows, the software developer's "safety-net". 

Quickly and easily eliminate the hardest-to-find 
Windows errors that can take days - even weeks 
to find like: 

• API Parameter Errors 

• API Return Value Errors 

• Data and Heap Corruption 

• Resource Leakage Problems 

• Memory Leakage Problems 

• Processor Faults 


HOW IT WORKS - BOUNDS-CHECKER works by 
transparently setting hundreds of breakpoints within 
your program to monitor its behavior. When a bug 
is detected, BOUNDS-CHECKER immediately stops 
your program and pops up showing the problem. 

You can then inspect your program's source, vari¬ 
ables, stack and heap ... with BOUNDS-CHECKER's 
powerful display windows. 

EVENTLOGGING - BOUNDS-CHECKER nowlogs 
all Windows events. Many Windows bugs are diffi¬ 
cult to find because of the event driven, multi-tasking, mes¬ 
sage based nature of Windows. BOUNDS-CHECKER V2.0 For 
Windows introduces an event logging and display capability 
that captures all Windows messages, API calls, API returns 
and other events. The information is displayed in a high-level 
overview that lets you see how your program is interacting 
with Windows. When you want to see more detail, simply click 
to see a section expanded in great detail. 

EASY TO USE — Unlike other debugging tools, there's no 
learning curve with BOUNDS-CHECKER. Simply select your 
program's name from BOUNDS-CHECKER's menu; all the rest 
is automatic. There is nothing to link-in and no macros to 
compile into your program. All this plus the functionality of a 
heap checker, super spy utility, debug kernel, API debugger, 
and a post mortem tool into a single comprehensive auto¬ 
matic bug finder. 


Nu Mega Technologies Demo 
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BCHKW - DEM03.EXE 


ir (irruu " 8) 

pPal->palV«rsion ■ 0; 
hPal ■ CreatePalttte (pPal); 


Parameter Validation Error 


Procedure: anpisplayFraae (001S8H) 
Rodule: bitmap.obi (bitmap.c line 


1 Stop j | Ignore | | Log | 


ANIMATES Regole , t Wo 
Dyoup (seg 2) 


BOUNDS-CHECKER Trapping a Parameter Validation Error 


For even greater debugging power get the 
Nu-Mega Power Pack! The Power Pack 
combines BOUNDS-CHECKER and Soft-ICE 
for Dos and Windows all bundled at great 
savings that put you in total control of both 
environments. And to make things even 
better you save over $400 and it comes in 
the great carrying case shown here. 

Call Today 


Call now for overnight delivery. 

BOUNDS-CHECKER V2.0 For Windows... Only $249 
BOUNDS-CHECKER For MS DOS... $199 
Order both versions & SAVE $150... Only $298 


BOUNDS CHECKER, SOFT-ICE, AND NU-MEGA TECHNOLOGIES are trademarks owned by Nu-Mega Technologies. Inc. All other trademarks are owned by their respective owners. 


con (603) 889-2386 
bax: (603) 889-1135 
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RISK = NULL 

30 DAY 

MONEY-BACK GUARANTEE 

P.O. Box 7780 
shua.NH 03060-7780 U.S.A. 

^TECHNOLOGIES INC 

24 HOUR BBS 
603-595-0386 
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